モジュール java.base
パッケージ java.lang.foreign

インタフェースGroupLayout

すべてのスーパー・インタフェース:
MemoryLayoutPREVIEW
既知のすべてのサブインタフェース:
StructLayoutPREVIEW, UnionLayoutPREVIEW
public sealed interface GroupLayout extends MemoryLayoutPREVIEW permits StructLayoutPREVIEW, UnionLayoutPREVIEW
GroupLayoutは、JavaプラットフォームのプレビューAPIです。
プレビュー機能が有効な場合のみ、プログラムでGroupLayoutを使用できます。
プレビュー機能は、今後のリリースで削除するか、Javaプラットフォームの永続機能にアップグレードすることができます。
複数の異種「メンバー・レイアウト」の集計である複合レイアウト。 メンバー・レイアウトを結合する方法は2つあります: メンバー・レイアウトが次々にレイアウトされている場合、結果のグループ・レイアウトは「構造体レイアウト」PREVIEWになります。逆に、すべてのメンバー・レイアウトが同じ開始オフセットでレイアウトされている場合、結果のグループ・レイアウトは「共用体レイアウト」PREVIEWになります。
実装要件:
このクラスは、不変、スレッド・セーフおよびvalue-basedです。
シール済クラス階層グラフ:
GroupLayoutの密封されたクラス階層グラフGroupLayoutの密封されたクラス階層グラフ
導入されたバージョン:
19

  • メソッドの詳細

    • memberLayouts

      List<MemoryLayoutPREVIEW> memberLayouts()
      このグループ・レイアウトのメンバー・レイアウトを返します。
      APIのノート:
      メンバー・レイアウトが返される順序は、グループ・レイアウトのファクトリ・メソッド(MemoryLayout.structLayout(MemoryLayout...)PREVIEW、MemoryLayout.unionLayout(MemoryLayout...)PREVIEWを参照してください)のいずれかにメンバー・レイアウトが渡される順序と同じです。
      戻り値:
      このグループ・レイアウトのメンバー・レイアウト

    • withName

      GroupLayoutPREVIEW withName(String name)
      このレイアウトと同じ特性を持つメモリー・レイアウトを、指定された名前で返します。
      定義:
      インタフェースMemoryLayoutPREVIEW内のwithName
      パラメータ:
      name - レイアウト名。
      戻り値:
      このレイアウトと同じ特性を持つが、指定された名前を持つメモリー・レイアウト
      関連項目:

    • withoutName

      GroupLayoutPREVIEW withoutName()
      このレイアウトと同じ特性を持つメモリー・レイアウトを名前なしで返します。
      定義:
      インタフェースMemoryLayoutPREVIEW内のwithoutName
      戻り値:
      このレイアウトと同じ特性を持つが名前のないメモリー・レイアウト
      関連項目:

    • withByteAlignment

      GroupLayoutPREVIEW withByteAlignment(long byteAlignment)
      このレイアウトと同じ特性を持つメモリー・レイアウトを返しますが、指定された整列制約(バイト単位)を使用します。
      定義:
      インタフェースMemoryLayoutPREVIEW内のwithByteAlignment
      パラメータ:
      byteAlignment - バイト単位で表されるレイアウト整列制約。
      戻り値:
      このレイアウトと同じ特性を持つメモリー・レイアウト。ただし、指定された整列制約(バイト単位)
      例外:
      IllegalArgumentException - byteAlignmentが2の累乗でない場合。
      IllegalArgumentException - byteAlignmentがMより小さい場合、Mは、このグループ・レイアウトに関連付けられているいずれかのメンバー・レイアウトの最大整列制約です。