Zig v0.17.0 リリースノート
要約
Zig v0.17.0がリリースされました。このバージョンでは、ビルドシステムの大幅な改修、ビルドサーバープロトコルの導入、ELFリンカーの強化が含まれています。また、多数のターゲットサポートの追加や改善、言語仕様の変更、標準ライブラリの更新など、5ヶ月にわたる206名のコントリビューターによる変更が反映されています。
全文翻訳
0.17.0 リリースノート
[画像: Carmen the Allocgator]
Zigは、堅牢で、最適化され、再利用可能なソフトウェアを維持するための汎用プログラミング言語およびツールチェーンです。
Zigの開発は、501(c)(3)非営利団体であるZig Software Foundationを通じて資金提供されています。コアチームメンバーへの請求可能な時間をより多く提供できるよう、定期的な寄付をご検討ください。これは、ロードマップに沿って1.0への道のりを加速する最も直接的な方法です。寄付領収書が必要な場合や、GitHub Sponsorsからの移行を検討している場合は、Every.org経由での寄付をお勧めします。
このリリースには、5ヶ月間の作業が含まれています。206名の異なる貢献者からの変更が、925コミットにわたって展開されています。
当初は短くなると予測されていましたが、このリリースサイクルは、ビルドシステムの再構築、ビルドサーバープロトコルの導入、およびELFリンカーの強化により、x86_64-linuxで段階的コンパイルがすべての人に機能するようになると期待されるほど、実質的なものとなりました。
目次 §
- 目次
- ターゲットサポート
- 言語変更
- 標準ライブラリ
- 非推奨事項
- StackFallbackAllocatorのリワークと名称変更
- SafeAllocatorの導入
- ArrayList
debug.SafetyLockが共有ロックをサポートfmt.allocPrintがmem.Allocatorに移動- フォーマット済み印刷の強化
std.zon.parseのリワークbit_setのバリアント名称変更と管理対象の非推奨化std.lang.Typeの配列構造体スタイルlang.OptimizeModeをlang.Optimizeに名称変更lang.Optimize.runtimeSafety- @import("builtin")の非推奨
- floatを
mem.eqlおよびmem.findDiffで正しく処理 - Uriと
net.HostNameの分離
- ビルドシステム
- コンパイラ
- リンカー
- ファズー
- バグ修正
- ツールチェーン
- ロードマップ
- 貢献者への感謝!
- スポンサーへの感謝!
ターゲットサポート §
[画像: Zero the Ziguana]
Zigは、幅広いアーキテクチャとオペレーティングシステムをサポートしています。サポートテーブルと追加プラットフォームのセクションでは、Zigがプログラムをビルドできるターゲットをカバーしており、zig-bootstrap READMEでは、Zig コンパイラ自体が簡単にクロスコンパイルできるターゲットをカバーしています。
注目すべき変更点:
aarch64-openbsdがZigのCIでネイティブにテストされるようになり、今後の高品質なサポートが保証されます。aarch64-freebsdおよびaarch64-netbsdのCIジョブが、masterプッシュに加えて、プルリクエストでも実行されるようになりました。- Zig コンパイラを含むほとんどの
aarch64-windowsバイナリを破損させていたLLVMのバグが回避されました。 - Zig コンパイラは、
aarch64-openbsdをターゲットにする際に、強制的なコードハードニング技術を適用するようになり、生成されるバイナリが実際に機能するようになりました。 - Zigは、32ビットARMでクラッシュやアサーション失敗時にスタックトレースを提供するようになりました。Thumb専用ターゲットについては、まだ作業が残っています。
- Zigは、SPARCでクラッシュやアサーション失敗時にスタックトレースを提供するようになりました。
- Zigは、AArch64でのスタックアンワインド時にポインタ認証オペコードを処理するようになりました。
loongarch32-linux-gnu[sf]ターゲットのサポートが追加されました。- Zigは、64ビットSPARC、特に
sparc64-linuxに対して、一般的に使用可能なサポートを提供するようになりました。これは、Zigの新しいELFリンカーが、LLDよりもこのターゲットに対して優れたサポートを提供しているおかげです。 - Zig 標準ライブラリは、それぞれx86-64のx32および64ビットMIPSのN32 ABIにポートされました。これらは、64ビット命令セットを使用しながら32ビットポインタのみを持つことができるニッチなILP32 ABIであり、アドレス空間の利用可能性をメモリ使用量とキャッシュ利用率の低下と引き換えにするという考え方です。
- ゲームコンソール用のターゲット情報が追加されました:
aarch64-switch、arm-gba、mipsel-psx、powerpc-wiiu。 xtensa-linuxの非常に初期のサポートがZigに追加されました。現時点では、このサポートはCバックエンドまたは実験的なLLVMバックエンドを通じてのみ利用可能です。- Zig 標準ライブラリは、Cバックエンドを使用する場合、
arc[eb]-linux、csky-linux、およびm88k-openbsdのサポートを提供するようになりました。 - Zig 標準ライブラリは、ノーリブlibcの
microblaze[el]-linux、sh[eb]-linux、およびsparc-linuxのサポートを提供するようになりました。 - Zigは、すべてのPowerPCターゲットに対して
-mabi=ieeelongdoubleを強制するようになりました。これは、すでに現実であったことの単なる形式化であり、ZigはIEEE「double-double」フォーマットをlong doubleに対してサポートしたことはなく、おそらく今後もサポートすることはないでしょう。その結果、このリリースではpowerpc-linux-gnueabi[hf]のサポートが削除されました。これらのターゲットではglibcのみが「double-double」フォーマットをサポートしているためです。powerpc-linux-musleabi[hf]ターゲットは、IEEEフォーマットを使用しているため、引き続きサポートされます。 - このリリースでは、
powerpc64-linux-gnuのサポートが削除されました。Zigは64ビットPowerPCに対してELFv2バイナリのリンクのみをサポートしてきましたが、glibcはビッグエンディアンでのELFv2を公式にはサポートしておらず、IEEElong doubleも上記のようにサポートしていません。 - ZigのネイティブCPUモデルと機能を検出する能力が全体的に大幅に向上しました。これは、サポートされているすべてのOSのほぼすべてのアーキテクチャに影響します。
- 一部のターゲットでベースラインCPUモデルが変更されました:
aarch64-haiku:cortex_a55m68k-*:M68030mips64-openbsd:octeonpowerpc-netbsd:750powerpc64-freebsd:pwr8powerpc64-linux:pwr8powerpc64-openbsd:pwr9s390x-*:arch11sparc-*:genericsparc-linux:v9sparc64-*:ultrasparcxtensa-*:esp32
- Zigのターゲットクエリ構文では、ネイティブlibcバージョン検出は、トリプルが実際にネイティブlibcを使用する場合(つまり、ABIコンポーネントが省略されている場合)にのみ発生するようになりました。この新しい動作は、特にOSコンポーネントの動作を考慮した場合、ターゲットクエリの動作方法に関する人々のメンタルモデルによりよく一致すると予想されます。
ティアシステム §
Zigのさまざまなターゲットに対するサポートレベルは、ティア1を最高位とする4つのティアに大別されます。ティア1ターゲットはテストが無効になっていないことを目指しており、これは1.0.0以降のZigリリースで必須となります。
ティア1 §
- すべての非実験的な言語機能が正しく動作することが確認されています。
- コンパイラは、LLVMに依存せずに、このターゲット向けの機械コードを生成できます。
- 統合されたファズーは、このターゲットで動作します(該当する場合)。
ティア2 §
- 標準ライブラリのクロスプラットフォーム抽象化には、このターゲットの実装があります。
- アサーションの失敗やクラッシュ時にスタックトレースが生成されます。
- libcは、クロスコンパイル時でもこのターゲットで利用可能です(該当する場合)。
- CIマシンは、すべてのプッシュでこのターゲットのモジュールテストをビルドします。
ティア3 §
- コンパイラは、LLVMなどの外部バックエンドに依存して、このターゲット向けの機械コードを生成できます。
- リンカーは、このターゲット向けのオブジェクトファイル、ライブラリ、および実行可能ファイルを生成できます。
ティア4 §
- コンパイラは、このターゲット向けのソースコードのアセンブリまたはCを生成できます。
サポートテーブル §
以下のテーブルでは、✅は完全なサポート、❌はサポートなし、⚠️は部分的なサポート(例:一部のサブターゲットのみ、またはいくつかの注目すべき既知の問題がある場合)を示します。❔は、ターゲットがほとんど実行されないため、ステータスが大部分不明であることを示します。その他のアイコンにはカーソルを合わせて詳細を確認してください。
🪦でマークされたターゲットは廃止予定です。Zigコンパイラと標準ライブラリは最善の努力でサポートを維持しますが、そのサポートは最終的に削除される予定です。
ティア
ターゲット
コード生成。
リンカー
言語機能
標準ライブラリ
スタックトレース
ファズー
libc
CI
1
🖥️⚡
✅
✅
✅
✅
✅
✅
✅
2
🖥️🛠️
✅
✅
✅
✅
✅
✅
✅
2
🖥️🛠️
✅
✅
✅
✅
✅
✅
✅
2
🖥️🛠️
✅
✅
✅
✅
✅
✅
✅
2
🖥️🛠️
✅
✅
✅
✅
✅
✅
✅
2
🖥️🛠️
✅
✅
✅
✅
✅
✅
✅
2
🖥️🛠️
✅
✅
✅
✅
❌
✅
✅
2
🖥️🛠️
✅
✅
✅
✅
❌
✅
⚠️
2
🖥️
✅
✅
✅
✅
❌
✅
✅
2
🖥️
✅
✅
✅
✅
❌
✅
✅
2
🖥️
✅
✅
✅
✅
❌
✅
⚠️
2
🖥️
✅
✅
✅
✅
❌
✅
⚠️
2
🖥️
✅
✅
✅
✅
❌
✅
✅
2
🖥🛠
✅
❔
✅
✅
❌
✅
⚠️
2
🖥️🛠️
✅
✅
✅
✅
✅
✅
✅
2
🖥️
✅
✅
✅
✅
❌
✅
✅
2
🖥️
✅
✅
✅
✅
❌
✅
⚠️
2
🖥️
✅
✅
✅
✅
✅
✅
✅
2
🖥️
✅
✅
✅
✅
❌
✅
⚠️
2
🖥️
✅
✅
✅
✅
❌
✅
⚠️
2
🖥️
✅
✅
✅
✅
❌
✅
⚠️
2
🖥️
✅
✅
✅
✅
❌
✅
⚠️
2
🖥️
✅
✅
✅
✅
❌
✅
⚠️
2
🖥️
✅
✅
✅
✅
❌
✅
✅
2
🖥️
✅
✅
✅
✅
❌
✅
⚠️
2
🖥️
✅
✅
✅
✅
❌
✅
✅
2
🖥️
✅
✅
✅
✅
✅
✅
⚠️
2
🖥️🛠️
✅
✅
✅
✅
✅
✅
⚠️
2
🖥️🛠️
✅
✅
✅
✅
✅
✅
✅
2
🖥️🛠️
✅
✅
✅
✅
✅
✅
⚠️
2
🖥️🛠️
✅
✅
✅
✅
❌
✅
⚠️
2
🖥️
✅
✅
✅
✅
✅
✅
✅
2
🖥️🛠️
✅
✅
✅
✅
✅
✅
✅
2
🖥️
✅
✅
✅
✅
❌
✅
✅
2
🖥️🛠️
✅
✅
✅
⚠️
❌
✅
✅
2
🖥️
✅
✅
✅
✅
❌
✅
✅
2
🖥️
✅
✅
✅
✅
❌
✅
✅
2
🖥️
✅
✅
✅
✅
❌
✅
⚠️
2 🪦
🖥️
✅
✅
✅
✅
❌
✅
✅
2
🖥️🛠️
✅
✅
✅
✅
✅
✅
✅
2 🪦
🖥️⚡
✅
✅
✅
✅
✅
✅
⚠️
2 🪦
🖥️⚡
✅
✅
✅
✅
✅
✅
⚠️
2
🖥️🛠️
✅
✅
✅
✅
✅
✅
✅
2
🖥️🛠️
✅
✅
✅
✅
❌
✅
✅
2
🖥️🛠️
✅
✅
✅
✅
❌
✅
✅
3
🖥️🛠️
✅
✅
✅
✅
❔
❌️
❌️
3
🖥️🛠️
✅
✅
✅
✅
❌
❌️
❌️
3
🖥️🛠️
✅
✅
✅
✅
❔
❌️
❌️
3
🖥️🛠️
✅
✅
✅
✅
❌
❌️
❌️
3
🖥️🛠️
✅
✅
✅
✅
❌
❌️
❌️
3
🖥️🛠️
✅
✅
✅
✅
❌
❌️
❌️
3
🖥️
✅
✅
✅
✅
❌
❌️
❌️
3
🖥️
✅
✅
✅
❌️
✅
❌️
❌️
3
🖥️🛠️
✅
✅
✅
✅
❔
❌️
❌️
3
🖥️🛠️
✅
✅
✅
✅
❔
❌️
❌️
3 🪦
🖥️
✅
✅
✅
✅
❌
✅
❌️
3
🖥️🛠️
✅
❔
❌️
⚠️
❌
❌️
❌️
3 🪦
🖥️
✅
✅
✅
✅
❌
✅
❌
3
🖥️
✅
✅
✅
✅
❌
❌️
❌️
3 🪦
🖥️
✅
✅
✅
✅
❌
❌️
❌️
3
🖥️🛠️
✅
✅
✅
✅
❔
❌️
❌️
3
🖥️⚡
✅
✅
✅
✅
❔
❌️
❌️
3
🖥️🛠️
✅
✅
✅
✅
❔
❌️
❌️
3
🖥️⚡
✅
✅
✅
✅
❔
❌️
❌️
4
📄
❌️
❔
✅
✅
❌
❌️
❌️
4
📄
❌️
❔
✅
✅
❌
❌️
❌️
4
📄
❌️
❔
✅
✅
❌
❌️
❌️
4
📄
❌️
❔
✅
✅
❌
✅
❌️
4
📄
❌️
❔
✅
✅
❌
✅
❌️
4
📄
❌️
❔
❌️
❌️
❌
❌️
❌️
4
📄
❌️
❔
✅
❌️
❌
❌️
❌️
4
📄
❌️
❔
✅
❌️
❌
❌️
❌️
4
📄
❌️
❔
❌️
❌️
❌
❌️
❌️
4
🖥️
❌️
❔
✅
✅
❌
✅
❌️
4
🖥️
❌️
❔
✅
✅
❌
✅
❌️
4
📄
❌️
❔
✅
✅
❌
❌️
❌️
4
📄
❌️
❔
✅
❌️
❌
❌️
❌️
4
📄
❌️
❔
✅
✅
❌
❌️
❌️
4
📄
❌️
❔
✅
❌️
❌
❌️
❌️
4
📄
❌️
❔
✅
❌️
❌
❌️
❌️
4
📄
❌️
❔
✅
❌️
❌
❌️
❌️
4
🖥️
❌️
❔
✅
✅
❌
✅
❌️
4
🖥️
❌️
❔
✅
❌️
❌
✅
❌️
4
🖥️🛠️
⚠️
✅
✅
❌️
✅
✅
❌️
4
🖥️🛠️
⚠️
✅
✅
❌️
❌
✅
❌️
4
🖥️
❌️
❔
✅
❌️
❌
❌️
❌️
OSバージョン要件 §
Zig標準ライブラリには、一部のサポートされているオペレーティングシステムに対する最小バージョン要件があり、それがZigコンパイラ自体に影響します。
| OS | Version |
|---|---|
| Darwin | 15.0+ |
| DragonFly BSD | 6.4+ |
| FreeBSD | 14.0+ |
| Linux | 5.10+ |
| NetBSD | 10.1+ |
| OpenBSD | 7.8+ |
| Windows | 10+ |
追加プラットフォーム §
Zigは、ティアシステムが完全には適用されないこれらのターゲットに対しても、さまざまなレベルのサポートを提供しています。
aarch64-driverkitaarch64[_be]-freestandingaarch64-fuchsiaaarch64-hurdaarch64-switchaarch64-uefialpha-freestandingamdgcn-amdhsaamdgcn-amdpalamdgcn-mesa3darc[eb]-freestandingarm[eb]-freestandingarm-3dsarm-fuchsiaarm-gbaarm-uefiarm-vitaavr-freestandingbpf(eb,el)-freestandingcsky-freestandingez80-freestandingez80-tioshexagon-freestandinghppa[64]-freestandingkalimba-freestandingkvx-freestandinglanai-freestandingloongarch(32,64)-freestandingloongarch(32,64)-uefim68k-freestandingm88k-freestandingmicroblaze[el]-freestandingmips[64][el]-freestandingmipsel-psxmipsel-pspmsp430-freestandingnvptx[64]-cudanvptx[64]-nvclor1k-freestandingpowerpc-wiiupowerpc[64][le]-freestandingpowerpc64-ps3propeller-freestandingriscv(32,64)[be]-freestandingriscv(32,64)-uefiriscv64-fuchsiariscv64-hurds390x-freestandingsh[eb]-freestandingsparc[64]-freestandingspirv(32,64)-openclspirv(32,64)-openglspirv(32,64)-vulkanspork8-freestandingthumb[eb]-freestandingthumb-fuchsiathumb-gbathumb-vitave-freestandingwasm(32,64)-emscriptenwasm(32,64)-freestandingx86[_16,_64]-freestandingx86[_64]-hurdx86[_64]-uefix86_64-driverkitx86_64-fuchsiax86_64-plan9x86_64-ps4x86_64-ps5xcore-freestandingxtensa[eb]-freestanding
言語変更 §
言語安定化の進捗 §
Zig 0.16.0のリリース以降、言語の安定化に向けて多くの進展がありました。これは私たちのロードマップにおける重要なステップであり、Zig 1.0のタグ付けの前に必要な条件です。
特に、前回のリリース以降、多くの言語提案について議論し、決定を下しました。約25件を承認し、約125件を却下しました。執筆時点では、CodebergのIssueトラッカーには23件の未決定の言語提案が、レガシーなGitHubのIssueトラッカーには61件の未決定の言語提案が残っています。したがって、この取り組みは言語設計の最終化に向けた重要な一歩を表していますが(いくつかの 主要な 決定 は残っています)。
@bitCastの変更 §
Zig 0.17.0では、@bitCastビルトインの定義が変更されました。
多くの場合、新しい動作は古い動作と同等です。特に、整数型と別の整数型間のキャスト、または整数型とpacked structまたはpacked union間のキャストは影響を受けません。
しかし、配列型またはベクトル型を含む@bitCast呼び出しのセマンティクスが変更されました。残念ながら、この変更はコンパイルエラーを引き起こさずに既存のコードを破損させる可能性があります。したがって、アップグレード時に配列型またはベクトル型を含む@bitCastの使用箇所を監査することが役立つ場合があります。
@bitCastの新しい定義は、値の論理ビット表現を異なる型として再解釈することです。以下の型は論理ビット表現を持つと見なされます。
void- 整数型(
comptime_intを除く) - 浮動小数点型(
comptime_floatを除く) - 整数ベースの型
enum(T)、packed struct(T)、およびpacked union(T) - これらの型の配列またはベクトル
整数型および浮動小数点型の場合、論理ビット表現は最下位ビットから始まり最上位ビットで終わります。配列型およびベクトル型の場合、すべての要素の論理ビット表現は、最初の要素から順に連結されます。
実際には、これは新しい@bitCast定義がリトルエンディアンターゲットで古い動作と大部分一致することを意味します。古い動作とは異なり、新しい動作は完全にエンディアンに依存しない、つまり操作はターゲットのエンディアンに関係なく同じように動作します。
新しい@bitCast定義は、以前は許可されていた一部の型間のキャストを禁止しています。特に、extern structまたはextern union型を含むキャストは許可されなくなりました。ほとんどの場合、そのようなキャストを使用していたコードは、値のメモリ内表現(「型パンニング」と呼ばれることもあります)を再解釈しようとしています。これを達成するには、@ptrCastまたはextern unionを使用してください。
const TwoBytes = extern struct {
b0: u8,
b1: u8,
};
test "type pun extern struct" {
const bytes: TwoBytes = .{ .b0 = 0x12, .b1 = 0xAB };
const int: u16 = @bitCast(bytes);
switch (std.lang.Endian.native) {
.little => try expectEqual(0xAB_12, int),
.big => try expectEqual(0x12_AB, int),
}
}
const std = @import("std");
const expectEqual = std.testing.expectEqual;
$ zig test bitcast_extern_struct.zig
/home/ci/.cache/act/1f0e6bdd7fee591a/hostexecutor/src/download/0.17.0/release-notes/bitcast_extern_struct.zig:7:31: error: cannot @bitCast from 'bitcast_extern_struct.TwoBytes'
const int: u16 = @bitCast(bytes);
^~~~~
/home/ci/.cache/act/1f0e6bdd7fee591a/hostexecutor/src/download/0.17.0/release-notes/bitcast_extern_struct.zig:1:25: note: struct declared here
const TwoBytes = extern struct {
~~~~~~~^~~~~~
⬇️
const TwoBytes = extern struct {
b0: u8,
b1: u8,
};
test "type pun extern struct" {
const bytes: TwoBytes = .{ .b0 = 0x12, .b1 = 0xAB };
const int_ptr: *align(1) const u16 = @ptrCast(&bytes);
switch (std.lang.Endian.native) {
.little => try expectEqual(0xAB_12, int_ptr.*
), // Note: corrected typo here
.big => try expectEqual(0x12_AB, int_ptr.*
), // Note: corrected typo here
}
}
const std = @import("std");
const expectEqual = std.testing.expectEqual;
$ zig test ptrcast_extern_struct.zig
1/1 ptrcast_extern_struct.test.type pun extern struct...OK
All 1 tests passed.
正式に仕様化されファズテストされた文法 §
Zigの正式な文法 grammar.peg と実際の言語実装は、多くの場所で一致していませんでした。おそらく、正式な文法は実際の手書きのトークナイザーとパーサーと100%一致したことは一度もなかったでしょう。
この問題は現在修正され、将来の文法変更や言語仕様作業のブロックが解除されました。
高レベルでは、アプローチはZigのgrammar.pegを入力として受け取り、単純な再帰下降パーサーを出力するツールを作成することでした。この生成されたパーサーは、ファズテストのオラクルとして使用され、手書きのstd.zig.Ast.parse()と比較されます。このアプローチは単一の真実の源を保証し、文法が変更された際の簡単なイテレーションを可能にします。
詳細:#36094
C翻訳の外部パッケージへの移行 §
@cImportはZig 0.16.0で非推奨となり、削除されました。さらに、このリリースではstd.Build.Step.TranslateCは、明示的なパッケージ依存関係である公式ZSF translate-cパッケージに置き換えられました。これはビルドステップが提供するものと同じ実装ですが、翻訳されたコードに対してより多くの設定オプションを提供し、メインのZigツールチェーンとは独立したリリース周期を持っています。
アップグレードガイド:
zig fetch --save git+https://codeberg.org/ziglang/translate-c#zig-0.17.x
--- a/build.zig
+++ b/build.zig
@@ -1,20 +1,22 @@
const std = @import("std");
+const Translator = @import("translate_c").Translator;
pub fn build(b: *std.Build) void {
const target = b.standardTargetOptions(.{});
const optimize = b.standardOptimizeOption(.{});
- const translate_c = b.addTranslateC(.{
- .root_source_file = b.path("src/c.h"),
+ const translate_c = b.dependency("translate_c", .{});
+
+ const translator: Translator = .init(translate_c, .{
+ .c_source_file = b.path("src/c.h"),
.target = target,
.optimize = optimize,
+ .link_system_libs = &.{
+ .{ .name = "glfw" },
+ .{ .name = "epoxy" },
+ },
// additional options now available that go here:
// https://codeberg.org/ziglang/translate-c#options
});
- const c_module = translate_c.createModule();
- c_module.linkSystemLibrary("glfw", .{});
- c_module.linkSystemLibrary("epoxy", .{});
-
const exe = b.addExecutable(.{
.name = "tetris",
.root_module = b.createModule(.{
@@ -24,7 +26,7 @@ pub fn build(b: *std.Build) void {
.imports = &.{
.{
.name = "c",
- .module = c_module,
+ .module = translator.mod,
},
},
}),
@backingIntと@fromBackingIntの追加 §
@backingIntおよび@fromBackingIntビルトインが新しく追加されました。これらのビルトインは、現在非推奨の@intFromEnumおよび@enumFromIntビルトイン(#35966)を置き換えます。
@backingIntは、すべてのenumと、明示的な整数型を持つビットパックに対して機能します。タグ付きunionにも機能し、アクティブなタグ値の基になる整数を返します。undefinedなenumまたはビットパックは、undefinedな基になる整数を生成します。
@fromBackingIntは結果の型を推論し、それは任意のenumまたは明示的な整数型を持つビットパックになります。それは、その基になる整数型のパラメータを取ります。enumの場合、基になる整数がundefinedであるか、無効なタグ値を生成する値を渡すと、安全チェックされた不正な動作が発生します。ビットパックの場合、undefinedな基になる整数を渡すと、undefinedなビットパックが生成されます。
@bitCastも、宛先型がenumの場合、無効なタグ値に対する安全チェックを実行するようになりました。
また、@backingIntの結果型を取得するためのstd.meta.BackingInt関数が追加されました。
Zigは、空のenumがインスタンス化不可能であるため、noreturnを基になる整数として要求するようになりました。
アップグレード例:
--- a/lib/std/Build.zig
+++ b/lib/std/Build.zig
@@ -145,7 +145,7 @@
pub fn addGeneratedFile(graph: *Graph, owner: *Step) Configuration.GeneratedFileIndex {
graph.generated_files.append(graph.arena, owner) catch @panic("OOM");
- return @enumFromInt(graph.generated_files.items.len - 1);
+ return @fromBackingInt(@intCast(graph.generated_files.items.len - 1));
}
pub fn dupeString(graph: *const Graph, bytes: []const u8) []const u8 {
@@ -2607,7 +2607,7 @@
.src_path, .cwd_relative, .relative, .dependency => {},
.generated => |gen| {
const graph = other_step.owner.graph;
- const generated_owner_step = graph.generated_files.items[@intFromEnum(gen.index)];
+ const generated_owner_step = graph.generated_files.items[@backingInt(gen.index)];
other_step.dependOn(generated_owner_step);
},
}
zig fmtは自動的にこのアップグレードを実行します。
@SpirvTypeの追加 §
SPIR-Vには、Zigの型システムに相当するものがない画像やサンプラーなどの型がいくつかあります。以前は、それらのいずれかに言及する唯一の方法はインラインアセンブリを介していましたが、これによりテクスチャやストレージバッファを通常のグローバル変数として宣言することが不可能でした。Zig 0.17.0は、受け入れられた提案#35240を実装し、他の型作成ビルトインと共に@SpirvTypeビルトインを追加しました。
@SpirvType(comptime options: std.lang.Type.Spirv) type
.samplerはOpTypeSamplerを作成します。.imageはOpTypeImageを作成します。.sampled_imageは、使用法が.sampledである画像型からOpTypeSampledImageを作成します。.runtime_arrayはOpTypeRuntimeArrayを作成します。配列型と同様に、インデックスアクセスをサポートし、lenフィールドを公開します。
SPIR-Vをターゲットにしていない場合にこのビルトインを使用するとコンパイルエラーになります。オプションはターゲットOSに対しても検証されます。
const std = @import("std");
const Image = @SpirvType(.{ .image = .{
.usage = .{ .sampled = f32 },
.format = .unknown,
.dim = ."2d",
.depth = .not_depth,
.arrayed = false,
.multisampled = false,
.access = .unknown,
} });
const SampledImage = @SpirvType(.{ .sampled_image = Image });
const texture = @extern(*addrspace(.constant) const SampledImage, .{
.name = "texture",
.decoration = .{ .descriptor = .{ .set = 0, .binding = 0 } },
});
const uv_in = @extern(*addrspace(.input) const @Vector(2, f32), .{
.name = "uv",
.decoration = .{ .location = 0 },
});
const color_out = @extern(*addrspace(.output) @Vector(4, f32), .{
.name = "color",
.decoration = .{ .location = 0 },
});
export fn main() callconv(.{ .spirv_fragment = .{} }) void {
color_out.* = std.spirv.imageSampleImplicitLod(texture, uv_in.*
);
}
$ zig build-obj spirv_type.zig -target spirv32-vulkan
配列乗算構文の削除 §
配列乗算構文 (a ** b) は、@splatに置き換えられました。
移行:
--- a/player/chromaprint.zig
+++ b/player/chromaprint.zig
@@ -35,7 +35,7 @@
const max_index = @min(window_size / 2, freqToIndex(max_freq));
const notes: [window_size]u8 = n: {
@setEvalBranchQuota(window_size);
- var result = [1]u8{0} ** window_size;
+ var result: [window_size]u8 = @splat(0);
for (min_index..max_index) |i| {
const freq = indexToFreq(i);
const octave = freqToOctave(freq);
@@ -123,7 +123,7 @@
num_rows: u32,
pub const init: RollingIntegralImage = .{
- .data = [1]Float{0} ** data_size,
+ .data = @splat(0),
.num_rows = 0,
};
@divCeilの追加 §
新しい@divCeilビルトインは、正の無限大に向かって丸められた整数除算を実行し、既存の@divTrunc、@divFloor、@divExactビルトインを補完します。
@divCeil(5, 3) == 2
@divCeil(-5, 3) == -1
他の除算ビルトインと同様に、呼び出し元はdenominator != 0であり、結果がオーバーフローしないことを保証する必要があります。
もうstd.math.divCeil(a, b) catch unreachableは不要です!
@hasDeclが公開宣言のみtrueを返すように §
以前は、@hasDeclは公開宣言と同一ファイル内の宣言に対してtrueを返していました。今後は、@hasDeclがどのファイルにあるかに関わらず、動作は同じになります。
const std = @import("std");
const Foo = struct {
bar: i32,
const baz = 1;
pub var quux = "xxx";
};
test "@hasDecl example" {
try std.testing.expect(!@hasDecl(Foo, "bar"));
try std.testing.expect(!@hasDecl(Foo, "baz")); // 0.17.0で変更
try std.testing.expect(@hasDecl(Foo, "quux"));
}
$ zig test hasdecl.zig
1/1 hasdecl.test.@hasDecl example...OK
All 1 tests passed.
comptime長のsliceへのポインタ配列のデリファレンスと型変換を許可 §
以下が許可されるようになりました:
const slice: []const u16 = &.{ 1, 2, 3 };
const array: [3]u16 = slice.*;
const array_ptr: *const [3]u16 = slice;
void{}構文の削除 §
void{}はもはや有効な構文ではありません。代わりに{}を使用してください(#15213)。
errdeferキャプチャの削除 §
errdefer |err| {
// `err`は返されたエラーでした。それを使って何かできました!
// 通常の`defer`/`errdefer`のように、このブロック内で`return`または`try`はできません。そのため、返されるエラーを変更することはできませんが、例えばログに記録することはできます。
}
キャプチャ(|err|)はもはや許可されません(#23734)。
移行するには、関数を2つに分割します。
fn processOneTarget(job: Job) void {
- errdefer |err| std.debug.panic("panic: {s}", .{@errorName(err)});
+ processOneTargetInner(job) catch |err| std.debug.panic("panic: {s}", .{@errorName(err)});
+}
+fn processOneTargetInner(job: Job) !void {
const target = job.target;
i0の削除 §
i0はもはや許可されるプリミティブ整数型ではありません。
この型は無意味であったため、直接の代替はありません。しかし、それを使用する箇所はほとんどすべてu0に透過的に置き換えることができます。
グローバルリンケージのinternalおよびlink_onceの削除 §
std.lang.GlobalLinkageのinternalおよびlink_onceタグは、コード生成およびリンキングにおける不明確なセマンティクスと不完全なサポートのため削除されました(#36956)。link_onceの使用はweakで対応できる可能性が高く、internalの代替は、単にシンボルを@exportしないことです。
標準ライブラリ §
- IEEE浮動小数点演算における指数関数のテーブル駆動実装に基づく
@expおよび@exp2のf128サポートを追加しました(Ping Tak Peter Tang著、128ビット数値に対応するように適応)(#31846)。 std.Io.Semaphore.waitTimeoutを追加しました(#31924)。- サンプリング、クエリ、および画像の書き込みのための
std.spirvヘルパーを追加しました(#36187)。 ArrayHashMap.setKeyは、インデックス全体を再計算しなくなりました(#32136)。std.Target.parseCpuModelは、エラーではなくオプションを返すようになりました。std.debug.Pdb: インラインソース位置情報の重複排除(#35438)。hash.crc名前空間全体の監査(#35952)。std.fs.path:relativeおよびresolveの追加バリアントを追加しました(#36784)。
非推奨事項 §
std.heap.memory_pool.AlignedManagedをstd.heap.memory_pool.Alignedに置き換えるために削除しました。std.heap.memory_pool.ExtraManagedをstd.heap.memory_pool.Extraに置き換えるために削除しました。std.builtinをstd.langに置き換えるために非推奨にしました。std.meta.fieldInfoを@typeInfoに置き換えるために非推奨にしました。std.meta.fieldNamesを@typeInfoに置き換えるために非推奨にしました。std.meta.fieldTypesを@typeInfoに置き換えるために非推奨にしました。std.DoublyLinkedList.popをstd.DoublyLinkedList.popLastに置き換えるために非推奨にしました。std.gpuをstd.spirvに名称変更しました。std.ascii.indexOfIgnoreCaseをstd.ascii.findIgnoreCaseに置き換えるために削除しました。std.ascii.indexOfIgnoreCasePosをstd.ascii.findIgnoreCasePosに置き換えるために削除しました。std.ascii.indexOfIgnoreCasePosLinearをstd.ascii.findIgnoreCasePosLinearに置き換えるために削除しました。std.bit_set.Integer.initEmptyをstd.bit_set.Integer.emptyに置き換えるために削除しました。std.bit_set.Integer.initFullをstd.bit_set.Integer.fullに置き換えるために削除しました。std.bit_set.Array.initEmptyをstd.bit_set.Array.emptyに置き換えるために削除しました。std.bit_set.Array.initFullをstd.bit_set.Array.fullに置き換えるために削除しました。std.enums.EnumSet.initEmptyをstd.enums.EnumSet.emptyに置き換えるために削除しました。std.enums.EnumSet.initFullをstd.enums.EnumSet.fullに置き換えるために削除しました。std.mem.containsAtLeastScalar2をstd.mem.containsAtLeastScalarに名称変更し、非推奨のcontainsAtLeastScalarを置き換えました。std.mem.readPackedIntNativeをstd.mem.readPackedIntに置き換えるために削除しました。std.mem.readPackedIntForeignをstd.mem.readPackedIntに置き換えるために削除しました。std.mem.writePackedIntNativeをstd.mem.writePackedIntに置き換えるために削除しました。std.mem.writePackedIntForeignをstd.mem.writePackedIntに置き換えるために削除しました。
潜在的なcontainsAtLeastScalarの落とし穴 §
以前非推奨だったcontainsAtLeastScalarはcontainsAtLeastScalar2に置き換えられました。これはAPIが十分に似ているため、使用箇所はコンパイルされる可能性がありますが、elementとminimumパラメータの位置が入れ替わったため、現在では誤った動作になります。
移行ガイド:
const result = containsAtLeastScalar(u8, "aa", 1, 'a');
⬇️
const result = containsAtLeastScalar(u8, "aa", 'a', 1);
StackFallbackAllocatorのリワークと名称変更 §
std.heap.StackFallbackAllocatorは、「小さなベクター」最適化に役立つ抽象化であり、一般的なケースは事前に割り当てられたスタックバッファに収まりますが、まれなケースでは動的なヒープ割り当てが必要です。以前のデザインにはいくつかの問題がありました。
- バッファのアライメントを指定する方法がありませんでした。
- バッファのサイズがジェネリックでした。
.allocator().get()の呼び出しは、他のすべてのallocatorとは異なり、型をミューテートし、ランタイム安全チェックを必要としました。
現在、バッファは、バッファを必要とするほとんどの他のstd APIと同様に、引数として提供されます。
その結果、StackFallbackAllocatorはBufferFirstAllocatorに名称変更され、std.heap.stackFallbackは削除されました。
移行ガイド:
var stack align(@max(
@alignOf(std.heap.StackFallbackAllocator(0)),
@alignOf(Item)),
) = std.heap.stackFallback(@sizeOf(Item), self.gpa);
const allocator = stack.get();
⬇️
var stack_buf: [1]Item = undefined;
var stack: std.heap.BufferFirstAllocator = .init(@ptrCast(&stack_buf), gpa);
const allocator = stack.allocator();
SafeAllocatorの導入 §
std.heap.DebugAllocatorは、以下の保証を持つスレッドセーフなallocatorに置き換えられました。
deinitはすべてのリークを報告し、すべてのバックアップメモリを解放します。- すべての割り当てミスマッチは、パニックまたはセグメンテーションフォルトを引き起こします。
- 他の
SafeAllocatorインスタンスからの割り当ては、パニックを引き起こします(Options.canaryが異なる場合)。 - 二重解放と操作(リサイズ、リマップ、解放)の競合は、パニックまたはセグメンテーションフォルトを引き起こします。
バックアップallocatorはメモリを再利用しないため、メモリも再利用せず、解放後のほとんどの書き込みはセグメンテーションフォルトを引き起こすか、最終的に検出されてパニックを引き起こします。
std.heap.DebugAllocatorおよびstd.heap.Checkは非推奨です。
すべての割り当ては、割り当てのメタデータとスタックトレースを含むAllocFooterで終了します。これはチェックサムによって保護されており、割り当ての上書きによる破損を検出し、カナリアの不一致を報告します。割り当てのメモリは、割り当てサイズから決定される固定オフセットにあるフッターを配置するために、最小アライメントAllocFooterを持ちます。割り当てのメモリは、以下のように格納されます。
- 小さな割り当ての場合は、線形に埋められたバケット内。
- バックアップallocatorからの直接の割り当て内。
割り当てを追跡するために、各スレッドはバックアップ割り当てのテーブルを維持します。テーブルは他のスレッドによって変更される可能性があるため、テーブルは新しいセグメントを作成することによってのみ拡張されるリンクリストです。各スレッドは解放されたエントリのリンクリストを維持し、これには他のスレッドのテーブルのエントリが含まれる場合があります。
プロデューサー・コンシューマー操作の場合、取得/解放順序は外部で提供されると想定されます。これは、メモリを再利用する他のすべてのスレッドセーフallocatorによっても想定されています。そうでない場合、割り当てられたメモリの再利用でデータ競合が発生する可能性があります。
allocator用の2つのファズテストも追加されました。これらは、メモリの再利用がないこと、返されたメモリが書き込み可能であること、および上書きされないことをチェックします。マルチスレッドファズテストは、テスト実行全体に使用される多数のワーカー・スレッドを生成します。TSANの下でこれらのテストを広範囲に実行しました。
標準ライブラリのテストを-Osafeコンパイラビルドおよび-Ddebug-allocatorでビルドする:
Benchmark 1 (3 runs): ./master-out/bin/zig test --zig-lib-dir lib lib/std/std.zig -femit-bin=test --test-no-exec
measurement mean ± σ min … max outliers delta
wall_time 29.4s ± 157ms 29.2s … 29.5s 0 ( 0%) 0%
peak_rss 2.24GB ± 3.49MB 2.23GB … 2.24GB 0 ( 0%) 0%
cpu_cycles 143G ± 999M 142G … 144G 0 ( 0%) 0%
instructions 268G ± 5.22M 268G … 268G 0 ( 0%) 0%
cache_references 13.1G ± 88.8M 13.0G … 13.2G 0 ( 0%) 0%
cache_misses 2.38G ± 30.7M 2.35G … 2.41G 0 ( 0%) 0%
branch_misses 634M ± 6.22M 629M … 641M 0 ( 0%) 0%
Benchmark 2 (3 runs): ./branch-out/bin/zig test --zig-lib-dir lib lib/std/std.zig -femit-bin=test --test-no-exec
measurement mean ± σ min … max outliers delta
wall_time 22.1s ± 88.6ms 22.0s … 22.2s 0 ( 0%) ⚡- 24.7% ± 1.0%
peak_rss 1.11GB ± 799KB 1.11GB … 1.11GB 0 ( 0%) ⚡- 50.3% ± 0.3%
cpu_cycles 136G ± 480M 136G … 137G 0 ( 0%) ⚡- 4.4% ± 1.2%
instructions 273G ± 2.07M 273G … 273G 0 ( 0%) 💩+ 1.6% ± 0.0%
cache_references 12.3G ± 71.3M 12.2G … 12.4G 0 ( 0%) ⚡- 6.0% ± 1.4%
cache_misses 2.02G ± 11.5M 2.01G … 2.03G 0 ( 0%) ⚡- 14.9% ± 2.2%
branch_misses 569M ± 2.65M 567M … 572M 0 ( 0%) ⚡- 10.2% ± 1.7%
ArrayList §
getLastOrNullは非推奨となり、lastに名称変更されました。getLastはlastと?の組み合わせに置き換えるために非推奨になりました。lastPtrが追加され、?*Tを返します。
移行ガイド:
if (list.getLastOrNull()) |foo| {
// ...
}
const foo = list.getLast();
⬇️
if (list.last()) |foo| {
// ...
}
const foo = list.last().?;
ArrayListポインタの安定性 §
これは、ArrayListの使用バグをより迅速に特定するのに役立つ機能強化です(#36239)。
debug.SafetyLockが共有ロックをサポート §
既存のlockおよびunlockメソッドは引き続き排他的に動作します。データが変更される可能性がある場合に使用する必要があります。新しいメソッドlockSharedおよびunlockSharedは、複数の独立したユーザーがデータを変更せずに読み取る状況での共有ロックに使用できます。
fmt.allocPrintがmem.Allocatorに移動 §
try std.fmt.allocPrint(arena, "{s}={d}", .{ x, y });
⬇️
try arena.print("{s}={d}", .{ x, y });
フォーマット済み印刷の強化 §
文字列をエスケープして二重引用符付き文字列リテラルに表示できるようにする"{q}"指定子は、UTF-8エンコードされたデータが変更されずに通過できるように、エスケープ規則を緩和しました。
"{qf}"は、format()の出力を二重引用符でエスケープするために導入されました。
std.zon.parseのリワーク §
std.zon.parseは、構造体引数を受け取るようになり、結果と診断の両方をアリーナから割り当てます。
移行ガイド:
var diag: std.zon.parse.Diagnostics = .{};
defer diag.deinit(gpa);
const result = std.zon.parse.fromSlice(
MyZonType,
gpa,
source,
&diag,
.{},
) catch |err| switch (err) {
error.ParseZon => std.process.fatal("input.zon: {f}", .{diag}),
error.OutOfMemory => |e| return e,
};
defer std.zon.parse.free(result);
⬇️
var diag: std.zon.parse.Diagnostics = undefined;
const result = std.zon.parse.fromSlice(MyZonType, .{
.gpa = gpa,
.arena = arena,
.source = source,
.diagnostics = &diag,
}) catch |err| switch (err) {
error.ParseZon => diag.fatal("input.zon"),
error.OutOfMemory => |e| return e,
}
一部のメソッドが名称変更されました。
fromSliceAlloc➡️fromSlicefromSlice➡️fromSliceNoAlloc- 他の「from」メソッドもこの同じスキームに従って名称変更されました。
「updateFrom」バリアント(例:updateFromSlice)が追加されました。これらは、ZONソースで指定されたフィールドでメモリ内の値を更新し、そのフィールドを上書きします。これは、ZONを使用して、優先順位が異なる設定ファイルをロードする場合に役立ちます。たとえば、テキストエディタがグローバル設定ファイルとプロジェクトごとの設定ファイルを持っている場合などです。
bit_setのバリアント名称変更と管理対象の非推奨化 §
一貫性のためにバリアントの型名を変更し、以前の名前と管理対象のバリアントを非推奨にしました。
std.bit_set.IntegerBitSet➡️std.bit_set.Integerstd.bit_set.ArrayBitSet➡️std.bit_set.Arraystd.StaticBitset、std.bit_set.StaticBitSet➡️std.bit_set.Staticstd.DynamicBitSetUnmanaged、std.bit_set.DynamicBitSetUnmanaged➡️std.bit_set.Dynamicstd.DynamicBitSet、std.bit_set.DynamicBitSet➡️std.bit_set.DynamicManaged(非推奨)
std.lang.Typeの配列構造体スタイル §
型リフレクションを行う際、構造体と共用体は配列構造体スタイルで情報を提供します(#35234)。
--- a/lib/compiler/Maker/ScannedConfig.zig
+++ b/lib/compiler/Maker/ScannedConfig.zig
@@ -49,9 +49,10 @@
pub fn print(sc: *const ScannedConfig, w: *Writer) Writer.Error!void {
}
fn printStruct(sc: *const ScannedConfig, s: *Serializer.Struct, comptime S: type, v: S) !void {
- inline for (@typeInfo(S).@"struct".fields) |field| {
- try s.fieldPrefix(field.name);
- try printValue(sc, s.container.serializer, field.type, @field(v, field.name));
+ const info = @typeInfo(S).@"struct";
+ inline for (info.field_names, info.field_types) |field_name, field_type| {
+ try s.fieldPrefix(field_name);
+ try printValue(sc, s.container.serializer, field_type, @field(v, field_name));
}
}
lang.OptimizeModeをlang.Optimizeに名称変更 §
そして、列挙型タグ名から「release」を削除しました。
機能的な変更はありませんが、このパッチで後方互換性のある宣言が追加されたにもかかわらず、==または!=演算子を使用する式が非推奨の名前を使用できなくなるため、破壊的な変更となります。
std.lang:OptimizeMode➡️OptimizeDebug➡️debugReleaseSafe➡️safeReleaseFast➡️fastReleaseSmall➡️small
lang.Optimize.runtimeSafety §
std.lang.Optimize.runtimeSafetyは、std.debug.runtime_safetyの代替として推奨されます。これは、標準ライブラリモジュールではなく、自身のモジュールに関するコールサイトの知識を提供するからです。
@import("builtin")の非推奨 §
@import("builtin")の冗長な定数cpu、os、abi、およびobject_formatは非推奨となり、0.18.0で削除される予定です。これらの使用箇所は、target定数の対応するフィールドに置き換えてください。
@import("builtin").cpu➡️@import("builtin").target.cpu@import("builtin").os➡️@import("builtin").target.os@import("builtin").abi➡️@import("builtin").target.abi@import("builtin").object_format➡️@import("builtin").target.ofmt
floatをmem.eqlおよびmem.findDiffで正しく処理 §
std.mem.eqlおよびstd.mem.findDiff関数は、2つの入力が同じメモリへのスライスである場合にショートサーキットします。このショートサーキットは、与えられた型の==演算子が反射的である場合にのみ正しいです。これはfloatの場合、例えばstd.math.nan(f64) != std.math.nan(f64)であるため、そうではありません。このPRの変更は、floatスライスを扱う際のその最適化を無効にします。
以前は失敗し、現在は成功するテスト:
const x: [3]f64 = .{ 42.0, std.math.nan(f64), 3.1415 };
try std.testing.expect(!std.mem.eql(f64, &x, &x));
try std.testing.expectEqual(1, std.mem.findDiff(f64, &x, &x));
Uriとnet.HostNameの分離 §
Uriは、host(resolveInPlace内)でHostName.validateを使用する場合と、そうでない場合(parseAfterScheme内)がありました。それ自体は問題でしたが、より大きな問題は、RFC3986(Uri)がRFC1123(HostName)よりも有効なホスト名とは何かについて大きく異なる考えを持っていることです。したがって、Uriが常にHostName.validateを使用するようにしただけでは、Uri全体の有用性が低下します。
代わりに、HostName関連のすべてがUriから削除されました。Uri.getHostはHostName.fromUriに移動されました(セマンティクスがユーザーが使用箇所を評価する必要があるほど異なるため、円滑な非推奨はありません)。一方、Uri.getHostAllocは完全に削除されました。
移行ガイド:
var host_buf: [HostName.max_len]u8 = undefined;
const host = try uri.getHost(&host_buf);
⬇️
var host_buf: [HostName.max_len]u8 = undefined;
// 注:fromUriは検証を行うため、エラーセットは以前とは異なります。
const host = try HostName.fromUri(uri, &host_buf);
ビルドシステム §
b.build_root(Directory) ➡️b.root(Path)ConfigHeader.Options:include_guard_override➡️include_guardLazyPath:getDisplayName➡️format("{f}")LazyPath.basename: 削除されました。値はmakeフェーズまで不明なためです。b.findProgramがfindProgramとfindProgramLazyに分割され、APIが将来性に対応しました。ConfigHeaderが修正されました。すべてのスタイルで未使用の値が報告されるようになりました。addArtifactArg、addPrefixedArtifactArg➡️addArtifactArg2addOutputFileArg、addPrefixedOutputFileArg➡️addOutputFileArg2addFileContentArg、addPrefixedFileContentArg➡️addFileContentArg2addOutputDirectoryArg、addPrefixedOutputDirectoryArg➡️addOutputDirectoryArg2addDirectoryArg、addPrefixedDirectoryArg、addDecoratedDirectoryArg➡️addDirectoryArg2addDepFileOutputArg、addPrefixedDepFileOutputArg➡️addDepFileOutputArg2addFileArg、addPrefixedFileArg➡️addFileArg2
MakerプロセスとConfigurerプロセスの分離 §
zig buildは現在、プロジェクトのbuild.zigコードを、パッケージ管理とビルドグラフの実行を実行する実行可能ファイルとは別の実行可能ファイルで実行します。これにより、zig buildはいくつかの理由で高速化されます(#35428):
maker実行可能ファイルは、build.zigスクリプトが編集されたときに変更されず、したがってZigをインストールした後に一度だけビルドする必要があります(「初回セットアップ」)。maker実行可能ファイルは最適化を有効にしてビルドされます。これは、--watchと--fuzzが導入された今、ますます価値が高まっています。build.zigロジックは、zig buildで使用されるCLIフラグによってはスキップされる場合があります。
さらに、構成はコンパクトなバイナリ形式にシリアライズされ、サードパーティツールで消費でき、新しいビルドサーバープロトコルの一部となります。以前のビルドランナーのフォークによるこのユースケースの満たし方は、サポートされなくなりました。
構成を.zonとして標準出力にレンダリングするには、--print-configurationを渡します。
キャッシュシステムの再構築 §
新機能:
- ディレクトリサポート。ディレクトリ内のエントリの追加、削除、または名前変更がキャッシュミスを引き起こす可能性。
- メタデータモード。通常、変更されたコンテンツのみがキャッシュミスを引き起こします。メタデータモードでは、サイズ、inode、mtimeが変更された場合、コンテンツに関係なく常にキャッシュミスが発生します。
これら4つの組み合わせすべてが可能です(is_directory=true/false、metadata_mode=true/false)。これらの機能は、ビルドシステムの新しいAPIとして公開されています。
Zigツールチェーンはキャッシュシステムに大きく依存しているため、このリリースではバイナリ形式に切り替え、ファイルサイズを約25%削減します。これにより、ファイルシステムキャッシュへの圧力がわずかに緩和され、コンピュータの作業も簡素化されます。ディスクから直接バイトをコピーするのではなく、テキストファイルを解析するのではなく。新しいzig cache-catサブコマンドは、トラブルシューティングやzig-cacheディレクトリ内のファイルの操作に利用できます。
キャッシュシステムは、ミスが発生した理由を説明する機能も備えるようになりました。std.Build.Cacheの公開APIには多くの破壊的な変更がありますが、コンパイラツールチェーンの外側では、このAPIはあまり使用されておらず、すべての変更により誤用が困難になっています。
この変更により、キャッシュヒットが5〜10%高速化されることが観測されています(#36822)。
Configure Cache Poisoningの概念導入 §
キャッシュがポイズニングされた場合、構成ロジックに副作用があったか、またはキャッシュシステムで追跡できない何らかの処理が行われたことを意味します。
これは、個々のステップが評価時に副作用を持つかどうかとは混同しないでください。これは、build.zig自体のロジックに関するものです。たとえば、「hello world」と表示するRunステップは、make時間中に副作用がありますが、このフラグを設定する価値はありません。一方、構成オプションのデフォルト値を決定するために、構成時間中にscdocの存在を確認することは、その価値があります。
キャッシュを純粋に保つことで、zig buildは高速化され、同一の構成が生成される場合にコンフィギュレータープロセスをバイパスします。
キャッシュがポイズニングされた場合、makerプロセスはビルド構成ファイルを摂取したときに削除します。これは再利用できないためです。
キャッシュをポイズニングする一般的な方法には、findProgramの呼び出し、またはより直接的にはstd.Build.Graph.poisonCacheがあります。キャッシュポイズニングよりも優れた代替手段は、これらの新しい関数を使用して構成依存関係を明示的に宣言することです。
std.Build.dependOnFileContents-build.zigロジックが特定のファイルの内容に依存していることを示します。std.Build.dependOnFileMetadata-build.zigロジックが特定のファイルのサイズ、inode、mtime、および内容に依存していることを示します。std.Build.dependOnDirectoryContents-build.zigロジックが特定のディレクトリのエントリに依存していることを示します。std.Build.dependOnDirectoryMetadata-build.zigロジックが特定のディレクトリの最終変更日に依存していることを示します。
高度なユーザーは、新しいCLIオプションでキャッシュポイズニング動作をオーバーライドできます。
--cache-poison[=mode] Override configuration caching behavior
pure (default) Avoid false positive cache hits
poisoned Don't cache the configuration
disallowed Panics when cache would be poisoned
ignored A little poison never hurt anybody
findProgram §
構成フェーズで即座に、ホスト上の実行可能ファイルを検索します。この実行可能ファイルは複数の名前を持つ可能性があります。
名前は順序通りに検索され、まず検索プレフィックス、次にPATH環境変数が考慮されます。
この関数を呼び出すと、構成キャッシュがポイズニングされるため、プログラムの存在またはその出力が構成ロジックによって観察される必要がある場合にのみ適切です。そのため、findProgramLazyも用意されています。
findProgramLazy §
ホスト上の実行可能ファイルを検索する匿名Stepを作成します。この実行可能ファイルは複数の名前を持つ可能性があります。
findProgramとは異なり、この関数は構成キャッシュをポイズニングしません。ただし、結果は構成フェーズで使用できないため、戻り値の型はLazyPathです。
見つかった実行可能ファイルのLazyPathを返します。検索は、LazyPathが依存するStepによって使用される場合にのみ実行されます。
このAPIは、以下のケースで役立ちます。
- バイナリ名がシステムごとに異なる場合(例:「python」対「python3」)。
- バイナリがソースからビルドされたものであり、グローバルにインストールされていない場合、検索プレフィックスパスのいずれかで見つかる可能性があります。
Runステップ: 引数のパススルー §
Runステップでは、パススルー引数はすべて一緒にまとめられ、構成フェーズで実行引数が提供されているかどうかを観察することはできません。
--- build.zig
+++ build.zig
@@
-if (b.args) |args| {
- run_cmd.addArgs(args);
-}
+run_cmd.addPassthruArgs();
これにより、ビルドスクリプトはこれらの引数を観察できなくなるため、ビルドスクリプトから機能が削除されます。その代わりに、これらの引数を変更しても、ビルドスクリプトをソースから再ビルドする必要がなくなることを意味します。
Fmtステップ: オプション §
pathsとexclude_pathsはLazyPathリストになりました。それらを作成するための便利なメソッドb.pathListがあります。
--- build.zig
+++ build.zig
@@
- const fmt_include_paths = &.{ "lib", "src", "test", "tools", "build.zig", "build.zig.zon" };
- const fmt_exclude_paths = &.{ "test/cases", "test/behavior/zon" };
+ const fmt_include_paths = b.pathList(&.{ "lib", "src", "test", "tools", "build.zig", "build.zig.zon" });
+ const fmt_exclude_paths = b.pathList(&.{ "test/cases", "test/behavior/zon" });
Step.Options: addOptionPathDirectoryの追加 §
現在、ファイルパスであるオプションを追加する場合、明示的に選択する必要があります(#36876)。
addOptionPath(ファイルである必要があります)addOptionPathDirectory(ディレクトリである必要があります)addOptionPathUntracked(依存関係追跡をオプトアウトします)
Lazy Dependencyの人間工学的な改善 §
- 遅延依存関係がフェッチされたときにログを記録します。
std.Build.dependency: 遅延依存関係をサポートします。std.Build.dependencyLazyを導入し、nullの代わりにerror.LazyDependencyNeededを返す可能性があるため、tryを使用できます。- ユーザーの
build関数がerror.LazyDependencyNeededを返した場合、ビルドシステムは構成を失敗させるのではなく、それらをフェッチに進みます。
Build Runnerのオーバーライド機能の削除 §
「ビルドランナー」という概念はもはや存在しません。それはコンフィギュレーターとメーカーに分割されました。
このユースケースは、ビルドサーバープロトコルによって処理されます。
パッケージ管理 §
すべてのパッケージ管理機能は、コンパイラからビルドシステムに移動されました。これには以下のサブコマンドが含まれます。
zig buildzig fetchzig initzig libczig cache-cat
これは、以前はコンパイラ実行可能ファイルに含まれていた機能の大部分が、ソース形式で出荷されるようになったことを意味します。これには以下が含まれます。
- パッケージフェッチロジック
- HTTPクライアントとネットワーキング
- TLS(トランスポート層セキュリティ)および関連する暗号
- gitプロトコル
- xz、gzip、zstd、flate、zip
build.zig.zonファイルの解析、検証、およびその他の処理
これらのすべての機能は、コンパイラ内にあるため、-Ofast最適化モードではなく-Osafe最適化モードでコンパイルされるようになりました。ビルドシステム自体をハッキングする場合、環境変数ZIG_DEBUG_CMD=1を使用して、ビルドシステムをデバッグモードでコンパイルできます。
その他の変更点:
- バグ修正:親パッケージルートからエスケープするパス依存関係を拒否します。
パッケージパスのオーバーライド機能 §
--pkg-path CLI引数とZIG_LOCAL_PKG_DIR環境変数が、fetchおよびbuildコマンドの両方で観測されるようになりました。
グローバルとローカルのフェッチ §
現在、zig fetchは以前と同様にグローバルキャッシュにのみフェッチします。ただし、--save(またはそのバリアント)が使用されている場合、ローカルパッケージパスにもフェッチします。パスによるフェッチの場合、ハッシュは常に計算され、圧縮されたtarballが常に作成され、既存のグローバルキャッシュエントリは常に上書きされます。
グローバルにフェッチする場合、build.zigが存在する必要はありません。zig buildは常にローカル(グローバルに加えて)にフェッチします。
特に、これは回帰したユースケースzig fetch .を修正します。
パスでフェッチする場合、ハッシュは常に計算され、再圧縮されたtarballは常に作成され、既存のグローバルキャッシュエントリは常に上書きされます。
DLL引数におけるPATHのわずかな違い §
以前は、WindowsまたはWineをターゲットにする場合、Runステップに追加されたアーティファクト引数は、DLL依存関係の再帰的なセットを含むディレクトリのセットに基づいてPATHを変更していました。現在は、これはargv[0]に対してのみ行われます。他のコマンドライン引数に対しても同様の処理を行う動機は不明です。なぜなら、argv[0]を実行するためにそれらのDLLをロードする必要はないからです。
ビルドサーバープロトコル §
現在、--listen=-が渡されると、ビルドシステムは、接続されたクライアントがビルドグラフの実行を監視および制御できるようにするプロトコルを提供します。これは、IDEなどのサードパーティツールによって消費されることを意図しています。
現在の機能:
- ビルドグラフの静的で構成後のすべての情報(利用可能なビルドステップ、設定されているオプション、依存関係など)に完全にアクセスできます。まだ含まれていないものがいくつかあります。たとえば、公開されているモジュール名のセットなどです。
- ビルドステップの開始と完了時に通知を受け取ります。エラー情報や生成されたファイルの情報も含まれます。
- 特定のステップのビルドを要求します。
特に、makerプロセスとコンフィギュレータープロセスの分離は破壊的な変更であり、ZLSプロジェクトが0.17.0で動作しなくなる原因となります。このリリースサイクル中に機能回復に向けた進展がありましたが、ZigチームとZLSチームは、ZLSが機能回復だけでなく、以前よりも強力で機能豊富なものになるまで、ビルドサーバープロトコルをさらに強化するために協力しています。
将来的には、Zig自身のファーストパーティビルドシステムツールの多くがビルドサーバープロトコルのクライアントになり、サードパーティツールが同等の機能を利用できるようにドッグフーディングすることが期待されています(#36497)。
また、ビルドサーバーがコンパイラサーバープロトコルをコンパイルステップに多重化し、型システム情報、リファクタリング、その他の高度な編集機能を提供する予定です(#615)。
コンパイラ §
段階的コンパイル §
Zigコンパイラの段階的コンパイル機能(コードを変更した後のほぼ瞬時のプロジェクト再ビルドを可能にする機能)は、Zig 0.17.0で大幅に改善されました。多くのバグが修正され、前リリースで導入された新しいELFリンカーは、この機能の優れたサポートを獲得しました。
これらの強化のおかげで、x86_64-linuxをターゲットとするほとんどのプロジェクトで段階的コンパイルを活用できるようになりました。 これを行うには、zig buildコマンドに引数-fincremental --watchを追加します(例:zig build -fincremental --watch)。これにより、Zigビルドシステムはソースファイルの変更を監視し、段階的な再ビルドを実行してそれらに反応します。
独自のプロジェクトで段階的コンパイルを使用する方法の詳細、またはこの機能が内部でどのように機能するかについてさらに学ぶには、Zigコアチームメンバーによるこのブログ投稿をご覧ください。
今後のリリースでは、この機能の改善が継続されます。新しいMach-Oリンカーと、段階的コンパイルの優れたサポートを備えたセルフホスト型aarch64バックエンドの導入、--watchなしで段階的コンパイルを使用するサポートの追加、および残りのバグの修正が含まれます。
SPIR-Vバックエンド §
セルフホスト型SPIR-Vバックエンドは、他のバックエンドと同様にマルチスレッドになりました。
LocalSizeやOriginUpperLeftなどの実行モードは、インラインアセンブリで設定するのではなく、関数の呼び出し規約から派生するようになりました。新しいspirv_taskおよびspirv_mesh呼び出し規約は、タスクおよびメッシュシェーダーのサポートを追加します(#35676)。
インラインアセンブリでのOpCapabilityおよびOpExtensionを使用した機能および拡張機能の宣言は、もはや許可されません。これらはターゲットCPU機能、つまり-mcpuオプションを通じて有効になります。
このリリースサイクル中に、SPIR-Vバックエンドで22件のバグが修正されました。
aarch64バックエンド §
これに向けた進捗は、このリリースサイクル中に完了した多くのリンカーの強化にブロックされています。
loongarchバックエンド §
loongarch64向けのセルフホスト型バックエンドの初期実装が貢献されました(#36418)。これはまだ実験的であり、まだ使用できません。このバックエンドに貢献するには2つの方法があります。直接取り組むこと、およびAIR Legalization Featuresに貢献することです。これは、すべての未完成のバックエンドがより早く完成するのを助けます。
WebAssemblyバックエンド §
ZigのWebAssemblyバックエンドは、LLVMバックエンドと比較して2060/2054(100%)の動作テストに合格するようになりました。ただし、デバッグ情報サポートの欠如(#37032)のため、デバッグ最適化モードでのコンパイル時にデフォルトにはなっていません。
リンカー §
ELF §
このリリースでは、前リリースで導入された新しい実装に、Zigのレガシーセルフホスト型ELFリンカーを置き換えるための大きな進歩が見られます。具体的な強化点は以下の通りです。
- 完全なx86_64サポート
- 完全なSPARC64サポート
- 部分的なLoongarchサポート
- 静的ライブラリ生成
- 共有ライブラリ生成
- 実行可能ファイルでの未定義シンボルのエラー
- GOT生成
- コピーリロケーション
- GNUシンボルバージョニング
- DWARFデバッグ情報
- シンボルハッシュテーブル生成
- ほぼ再現可能なバイナリ
- 任意のセクションアライメント
- 小さなホストファイルシステムブロックサイズへの対応
このリンカーは、古いセルフホスト型ELFリンカーの機能パリティにはまだ完全には達していませんが(そのためデフォルトでは無効のままです)、x86_64-linuxをターゲットとするほとんどのZigプロジェクトをビルドできる実用的な能力を備えています。これにより、これらのプロジェクトで段階的コンパイルを使用できるようになります。Zig 0.16.0と同様に、新しいリンカーはこの場合デフォルトで有効になります。
次のZigリリースでは、レガシーELFリンカーをこの実装に完全に置き換えることを目指しています。
COFF §
リンカーのCOFFサポートは、以下の機能で強化されました(#35674)。
- オブジェクト(
.obj)およびアーカイブ(.lib)の出力 - イメージと並行してimplibの出力
- イメージのTLSおよびExportsデータディレクトリの出力
- オブジェクト、アーカイブ、およびインポートライブラリを入力として消費
- アーカイブ内のオブジェクトは、参照を満たすために必要なシンボルが含まれている場合にのみリンクされます。
- COMDATルール(
compiler_rtとlibcのリンクに必要なサポートがありますが、一部のCOMDATタイプはまだサポートされていません)。 -gnuおよび-msvclibcの両方とリンクするサポート- TLSサポート
__dllimportサポート:IATからの間接呼び出し/ロード- エクスポートされたシンボルに基づいて、どのエントリポイントを選択するかを検出します。
-gnu: コンストラクタ/デストラクタサポート(例:.ctorおよび.dtorのマージ、および__CTOR_LIST__、__DTOR_LIST__シンボルの設定)。- いくつかの
.drectve引数のサポート(これらはmsvclibcを正しくリンクするために必要です)。/INCLUDE: シンボルを強制的に参照させる。/ALTERNATENAME: シンボルエイリアスの追加。/MERGE: セクションのマージ。この機能は、特定のセクションを適切な場所(.ctor/.dtorを.rdataなど)に配置するためにも使用されます。/DEFAULTLIB: 新しい入力を追加します。
新しいリンカーテストフレームワーク §
Zigは、リンカーのスナップショットベースのテストに向けて移行しています。
テストは、objdumpスナップショット出力の比較、アーティファクトの実行、およびリンカーエラーのチェックの組み合わせです。
zig build -Dlink-snapshot-updateは、テストをスナップショットをチェックする代わりにスナップショットを出力するモードで実行させます。
典型的な新しいテストの追加ワークフロー:
- テストを追加します。
zig-debug build test-link -Dtest-filter=my-test -Dlink-snapshot-update- これにより、
verifyObjdump呼び出しで定義されたすべてのスナップショットの組み合わせに対して.dmpファイルが出力されます。 - 単一のスナップショットは、スナップショットフォルダのノイズを減らすために多くのターゲット間でエイリアスされるため、スナップショットの更新は、そのスナップショット名で最初に実行されたテストによって行われます。ターゲット間に違いがある場合、それらはステップ4で明らかになります。
- これにより、
- 正確性のためにスナップショット出力を検査します。
zig-debug build test-link -Dtest-filter=my-test- これにより、すべてのターゲットが新しいスナップショットに対して実行されます。
- スナップショットの失敗が発生した場合、それは異なるターゲットが異なるスナップショット出力を生成したことを意味します。出力は、これらの結果が実際に有効な違いであるかどうかを検査する必要があります。そうである場合、
scopeパラメータを使用して、-Dlink-snapshot-updateがスナップショットを異なるファイル名に出力するようにします。これは違いに基づいてスコープされます。 - 新しいスナップショットセットを更新するために
-Dlink-snapshot-updateを再実行します。
SPIR-V §
SPIR-Vリンカーは書き直されました(#36828)。段階的コンパイルをサポートし、外部.spvオブジェクトファイルをリンクできます。
ファズー §
このリリースのビルドシステムの変更は、Zigの統合ファズーとそのビルドシステムとの連携に間接的に関連していますが、ファズー自体に変更はありません。
将来のリリースサイクルでファズーの改善に注力する予定です。
バグ修正 §
このリリースサイクル中にクローズされた329件のバグレポートの完全なリスト:
多くのバグがこのリリースサイクル中に導入され、解決されました。簡潔にするため、ほとんどのバグ修正はこのリリースノートから省略されています。
このリリースにはバグが含まれています §
Zigには既知のバグ、誤コンパイル、およびリグレッションがあります。
Zig 0.17.xであっても、非自明なプロジェクトをZigで使用するには、開発プロセスへの参加が必要になる場合があります。
Zigが1.0.0に到達すると、ティア1サポートには追加の要件としてバグポリシーが追加されます。
注目すべきリグレッション §
0.17.0での以下の注目すべきリグレッションを認識しています。
- #37006:
compiler-rtがx86のソフトフロートでコンパイルに失敗する。 - #36986:
std.debug.simple_panicがコンパイルに失敗する。 - #36986: Weak Zig libcシンボルを確実にオーバーライドできない。
- #36444: makerプロセスとコンフィギュレータープロセスの分離が
std.Build.Step.Runのレスポンスファイルの使用ケースを壊す。 - #37050: SPIR-Vバックエンドのリグレッション。
ツールチェーン §
LLVM 22 §
このZigリリースはLLVM 22.1.8にアップグレードされます。これにはClang(zig cc)、libc++、libc++abi、libunwind、およびlibtsanも含まれます。
ループベクトル化の無効化によるリグレッション回避 §
Zigの以前のリリースでは、Zigコンパイラに影響を与える誤コンパイルを回避するために、重要なLLVM最適化パスであるループベクトル化を無効にする必要がありました。
その回避策を最初に導入して以来、修正がLLVMのメインブランチにマージされました。しかし、この修正はZig 0.17.0で使用されているLLVMバージョンであるLLVM 22では利用できません。したがって、この回避策は現在も有効になっています。
Zig 0.18.0はLLVM 23にアップグレードされるため、この最適化パスを再度有効にできるようになります。
musl 1.2.5 §
Zig 0.17.0は、musl 1.2.5に加えて、バックポートされたセキュリティおよびポータビリティ修正を配布します。一方、アップストリームは1.2.6をタグ付けしました。Zig 0.18.0はmusl 1.2.6に更新されます。
muslを静的にターゲットにする場合、多くの関数はソースファイルからコピーされたmuslではなく、zig libcによって提供されるようになりました。したがって、Zigによって提供されるmusl libcでバグが発生した場合は、muslのIssueトラッカーではなく、ZigのIssueトラッカーに報告してください。
glibc 2.44 §
glibcバージョン2.44がクロスコンパイル時に利用可能になりました。
このリリースには、バージョン7.2のLinuxカーネルヘッダーが含まれています。
このリリースには、バージョン27.0のmacOSシステムヘッダーが含まれています。
MinGW-w64 §
Zig 0.17.0は、MinGW-w64コミット31bd54ab7d5fe03c67ed2bb1a57e531b9c7f8cc4を配布します。
ただし、多くの関数は、MinGW-w64からコピーされたソースファイルではなく、zig libcによって提供されるようになりました。したがって、Zigによって提供されるMinGW-w64 libcでバグが発生した場合は、MinGW-w64のIssueトラッカーではなく、ZigのIssueトラッカーに報告してください。
NetBSD 11.0 libc §
NetBSD libcバージョン11.0がクロスコンパイル時に利用可能になりました。
OpenBSD 7.9 libc §
OpenBSD libcバージョン7.9がクロスコンパイル時に利用可能になりました。
WASI libc §
Zig 0.17.0は、WASI libcコミットc89896107d7b57aef69dcadede47409ee4f702eeを引き続き配布します。
ただし、多くの関数は、WASI libcからコピーされたソースファイルではなく、zig libcによって提供されるようになりました。
さらに、Zig 0.18.0以降、サードパーティのWASI libcコードを配布する代わりに、Zigはzig libcを通じてWASIターゲット用のlibcを提供します。詳細については、以下を参照してください。
zig libc §
libc.txtファイルでは、gcc_dirフィールドがcc_dirに名称変更され、GCC固有ではないことを反映しています。古い名前は引き続き受け入れられますが、ユーザーはlibc.txtを新しい名前に移行することが推奨されます(#36951)。
さらに、Linuxターゲットではcc_dirが必須になりました。AndroidとOpenHarmonyは関連するオブジェクトファイルを異常な場所に格納するため、これらのターゲットのユーザーはcc_dirをcrt_dirと同じパスに設定したい場合があります。
zig cc §
zig ccおよびzig c++は、Clang 22.1.8に基づいています。
zig objdump §
これはスナップショットテストの要件であり、COFFリンカーの開発にも役立ちました。
サポートされている機能:
Usage: zig objdump [options] file
Options:
-h, --help Print this help and exit
--all-headers Alias for --file-headers --linker-member=2 --member-headers --section-headers --relocs --symbols
--exports[=sort] Display exported symbols.
In the case of COFF import libraries, displays the symbol list and import headers.
Specify =sort to optionally sort the import headers by symbol name.
--file-headers Display file-format specific headers
--imports Display imported symbols
--linker-member[=1|2|longnames] (Coff) Display contents of the specified archive linker member (default 2)
--member-headers Display archive member headers
--elements=[e1],[e2],-[e3],... Select which formatting elements are displayed. Intended for snapshot testing.
file-type File type summary
header-name Name that precedes a header block
member-path Display full member paths. If removed, only basenames will be used.
newlines Newlines between output sections
table-header Table headers with column names
all (default) All of the above
--only-member=[name] Only consider archive members names that contain [name]. Can be specified multiple times.
--only-section=[name] Only consider section names that contain [name]. Can be specified multiple times.
--only-symbol=[name] Only consider symbol names that contain [name]. Can be specified multiple times.
--redact=[kind] Redact the specified field kind. Intended for snapshot testing.
rva Relative virtual addresses
va Virtual addresses and file offsets
ord Symbol ordinals / hints
size Sizes and lengths
all All of the above
--relocs Display relocations
-s, --snapshot Alias for --redact=all --elements=-all
--section-headers Display section headers
--strings Display string tables
--symbols Display symbol tables
--tls Display TLS information
いくつかの出力例:
❯ zig objdump mathtest-dync-exe-no-llvm.dll --all-headers
mathtest-dync-exe-no-llvm.dll: PE/COFF image
COFF Header:
8664 machine (AMD64)
7 number_of_sections
6a08670a time_date_stamp
0 pointer_to_symbol_table
0 number_of_symbols
f0 size_of_optional_header
2022 flags
| EXECUTABLE_IMAGE
| LARGE_ADDRESS_AWARE
| DLL
COFF Optional Header:
20b magic (PE32+)
14.00 linker_version
14a400 size_of_code
84e00 size_of_initialized_data
0 size_of_uninitialized_data
1000 address_of_entry_point ( 180001000)
1000 base_of_code ( 180001000)
180000000 image_base
1000 section_alignment
200 file_alignment
6.00 operating_system_version
1.00 image_version
6.00 subsystem_version
0 win32_version_value
1d6000 size_of_image
400 size_of_headers
0 checksum
2 subsystem (WINDOWS_GUI)
160 dll_flags
| HIGH_ENTROPY_VA
| DYNAMIC_BASE
| NX_COMPAT
100000 size_of_stack_reserve
1000 size_of_stack_commit
100000 size_of_heap_reserve
1000 size_of_heap_commit
0 loader_flags
10 number_of_rva_and_sizes
Data Directories:
1b48d0 54 EXPORT
1b4924 8c IMPORT
0 0 RESOURCE
1cc000 633c EXCEPTION
0 0 SECURITY
1d4000 1280 BASERELOC
1bc000 1c DEBUG
0 0 ARCHITECTURE
0 0 GLOBALPTR
1aebc8 28 TLS
0 0 LOAD_CONFIG
0 0 BOUND_IMPORT
1b4c80 2d0 IAT
0 0 DELAY_IMPORT
0 0 COM_DESCRIPTOR
0 0 RESERVED
Sections in 'mathtest-dync-exe-no-llvm.dll':
Num Name RVA Virt Size Data Size & Data & Relocs & Lines # Relocs # Lines Flags
1 .text 1000 14a346 14a400 400 0 0 0 0 60000020 | CNT_CODE MEM_EXECUTE MEM_READ
2 .rdata 14c000 6fe3c 70000 14a800 0 0 0 0 40000040 | CNT_INITIALIZED_DATA MEM_READ
3 .buildid 1bc000 52 200 1ba800 0 0 0 0 40000040 | CNT_INITIALIZED_DATA MEM_READ
4 .data 1bd000 e2a0 d200 1baa00 0 0 0 0 c0000040 | CNT_INITIALIZED_DATA MEM_READ MEM_WRITE
5 .pdata 1cc000 633c 6400 1c7c00 0 0 0 0 40000040 | CNT_INITIALIZED_DATA MEM_READ
6 .tls 1d3000 20 200 1ce000 0 0 0 0 c0000040 | CNT_INITIALIZED_DATA MEM_READ MEM_WRITE
7 .reloc 1d4000 1280 1400 1ce200 0 0 0 0 42000040 | CNT_INITIALIZED_DATA MEM_DISCARDABLE MEM_READ
No symbol table found
この出力が特定のexportの存在をテストしたいスナップショットテストに使用された場合:
❯ zig objdump mathtest-dync-exe-no-llvm.dll --exports --only-symbol=add --redact=rva --elements=-all
Export directory:
0 flags
0 time_date_stamp
0.00 version
xxxxxxxxxxxxxxxx name_rva
1 ordinal_base
1 number_of_entries
1 number_of_names
xxxxxxxxxxxxxxxx export_address_table_rva
xxxxxxxxxxxxxxxx name_pointer_table_rva
xxxxxxxxxxxxxxxx ordinal_table_rva
1 0 xxxxxxxx | add
リダクション(--redact=)および要素削除(--elements=)機能は、テストしたい特定の値を削除するために使用されます。これにより、例えば、リンカーの無関係な変更によってシンボルのRVAが変更された場合に、偽の失敗が発生するのを防ぎます。-sはすべてのリダクションを有効にし、すべての追加出力要素を削除するショートカットですが、特定のテストでは、特定の値を気にする場合はこれを使用しない場合があります。
resinator §
Windowsリソースコンパイルの外部パッケージへの移行 §
Windowsリソーススクリプトコンパイルは、コンパイラから次のリリースで公式だが外部のビルドシステムパッケージに移行されます。そのため、関連するstd.Build関数とフィールド(Build.Module.addWin32ResourceFileなど)はこのリリースで非推奨とマークされました。
zig rcサブコマンドは、Zigツールチェーンを他のビルドシステムで使用するユースケースをサポートし続けるために、この変更後も残ります。
zig fmt §
--complexityフラグの追加 §
トークンとASTノードをカウントするシンプルなツールであり、行数よりも洞察力のあるヒューリスティックを使用して、ソースファイルへの編集が複雑さをどのように増加または減少させるかを共有するために使用できます。
たとえば、古いELFリンカーディレクトリに実行してみます。
info: src/link/Elf/gc.zig: tokens=1538 nodes=770
info: src/link/Elf/Atom.zig: tokens=15576 nodes=7768
info: src/link/Elf/Merge.zig: tokens=2288 nodes=1092
info: src/link/Elf/Thunk.zig: tokens=1128 nodes=519
info: src/link/Elf/SharedObject.zig: tokens=4566 nodes=2236
info: src/link/Elf/eh_frame.zig: tokens=4840 nodes=2335
info: src/link/Elf/Symbol.zig: tokens=3770 nodes=1872
info: src/link/Elf/synthetic_sections.zig: tokens=13287 nodes=6375
info: src/link/Elf/Object.zig: tokens=13903 nodes=6842
info: src/link/Elf/LinkerDefined.zig: tokens=4140 nodes=2091
info: src/link/Elf/relocatable.zig: tokens=3598 nodes=1848
info: src/link/Elf/Archive.zig: tokens=2176 nodes=1028
info: src/link/Elf/ZigObject.zig: tokens=20783 nodes=10274
info: src/link/Elf/AtomList.zig: tokens=1819 nodes=933
info: src/link/Elf/relocation.zig: tokens=1289 nodes=551
info: src/link/Elf/file.zig: tokens=2330 nodes=1087
info: total: tokens=97031 nodes=47621