0Pricing
Zig Academy · レッスン

extern structとABIレイアウト

C structのメモリレイアウトに合わせます

「extern structとABIレイアウト」はCoddyKit上の無料Zig Academyレッスンです。 これはレッスン4/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはZig Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 Zig Academyコースには全4レッスンが含まれています。

Cと連携する

ZigからCコードを呼び出すときは、両者がメモリレイアウトに同意していなければなりません。この共有される契約が ABI です。

通常のStructには保証がない

通常のstructでは、フィールドの順序やパディングをZigが自由に決めるため、そのレイアウトがCライブラリの期待と一致しない場合があります。

extern structを指定する

型にextern structを指定すると、ZigはC ABIに従ってフィールドを配置し、Cのstructとフィールド単位で一致させます。

const Point = extern struct {
    x: i32,
    y: i32,
};

フィールドの順序を維持する

extern structはCと同じように宣言順序を維持するため、最初のフィールドは常にメモリ上でも先頭になります。

Cと同じパディング

packed structとは異なり、extern structはアラインメントのためにパディングを追加します。これはCコンパイラーの動作とまったく同じです。

PackedとExternの比較

ビット単位で正確なレイアウトにはpackedを、Cのバイトレイアウトとの一致にはexternを使います。両者は異なるレイアウト上の問題を解決します。

StructをCに渡す

extern structはそのままC関数に渡せます。関数がコンパイルされたヘッダーとレイアウトが一致しているためです。

extern fn use_point(p: Point) void;

サイズを確認する

@sizeOfを使うと、extern structがCと一致していることを確認できます。アラインメント用のパディングを含む合計バイト数が返されます。

const n = @sizeOf(Point); // 8

フィールドのオフセットを調べる

@offsetOfを使うと、各フィールドがどこから始まるかを正確に確認できます。structがCと正しく対応しているかの検証に便利です。

const off = @offsetOf(Point, "y"); // 4

C互換型のみ

extern structのフィールドにはC互換型を使う必要があるため、スライスのようなZig固有の型は内部に含められません。

Cへの橋渡し

extern structとC ABIを組み合わせることで、ZigとCはレイアウトについてコピーや推測をせずに安全にデータを共有できます。🔗

クイックチェック

extern structが何との一致を目的としているか思い出してください。

まとめ

extern structはC ABIに一致し、フィールド順序とC形式のパディングを持つこと、Cに渡せること、@sizeOfと@offsetOfで検証できることを学びました。🎉

よくある質問

「extern structとABIレイアウト」レッスンは無料ですか？

はい。「extern structとABIレイアウト」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、Zig Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 Zig Academyコースには全4レッスンが含まれています。

「extern structとABIレイアウト」で何を学びますか？

C structのメモリレイアウトに合わせます ブラウザで直接実行するハンズオンコードでZig Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。

Zig Academyを始めるのに経験は必要ですか？

事前経験は必要ありません。CoddyKitのZig Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン4/4です。

「extern structとABIレイアウト」レッスンにはどのくらい時間がかかりますか？

ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。

このZig Academyレッスンでコードを書いて実行できますか？

はい。すべてのZig Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。

このコースのすべてのレッスン

  1. 正確なレイアウトのためのpacked struct
  2. u3のような任意ビット幅整数
  3. ビットフィールドとフラグ
  4. extern structとABIレイアウト
← Zig Academyに戻る