模块 java.base

包 java.lang.foreign

接口 GroupLayout

所有父级接口：

MemoryLayoutPREVIEW

所有已知的子接口：

StructLayoutPREVIEW , UnionLayoutPREVIEW

public sealed interface GroupLayout extends MemoryLayout PREVIEW  permits StructLayout PREVIEW , UnionLayout PREVIEW 
      

GroupLayout 是 Java 平台的预览 API。

程序只能在启用预览功能时使用 GroupLayout。

预览功能可能会在未来的版本中删除，或升级为 Java 平台的永久功能。

聚合多个 member layouts 的复合布局。成员布局有两种组合方式：如果成员布局一个接一个地布局，则生成的组布局被称为struct layout（参见MemoryLayout.structLayout(MemoryLayout...) ^PREVIEW );相反，如果所有成员布局都以相同的起始偏移量布置，则生成的组布局被称为 union layout（请参阅 MemoryLayout.unionLayout(MemoryLayout...) ^PREVIEW ).

实现要求：

此类是不可变的、线程安全的和 value-based 。

自从：

19

内部类总结

在接口 java.lang.foreign.MemoryLayout 中声明的嵌套类/接口^PREVIEW

MemoryLayout.PathElementPREVIEW

方法总结

修饰符和类型	方法	描述
List<MemoryLayoutPREVIEW>	memberLayouts()	返回与该组关联的成员布局。
GroupLayoutPREVIEW	withBitAlignment(long bitAlignment)	返回与此布局具有相同大小和名称但具有指定对齐约束（以位为单位）的相同类型的内存布局。
GroupLayoutPREVIEW	withName(String name)	返回与此布局具有相同大小和对齐约束但具有指定名称的相同类型的内存布局。

在接口 java.lang.foreign.MemoryLayout 中声明的方法^PREVIEW

bitAlignment, bitOffset, bitOffsetHandle, bitSize, byteAlignment, byteOffset, byteOffsetHandle, byteSize, equals, hashCode, name, select, sliceHandle, toString, varHandle

方法详情

memberLayouts

List <MemoryLayout PREVIEW > memberLayouts()
            

返回与该组关联的成员布局。

API 注意：

返回成员布局的顺序与将成员布局传递给组布局工厂方法之一的顺序相同（参见MemoryLayout.structLayout(MemoryLayout...) ^PREVIEW , MemoryLayout.unionLayout(MemoryLayout...) ^PREVIEW ).

返回：

与该组关联的成员布局。

withName

GroupLayout PREVIEW  withName(String  name)
            

返回与此布局具有相同大小和对齐约束但具有指定名称的相同类型的内存布局。

指定者：

withName 在接口 MemoryLayoutPREVIEW 中

参数：

name - 布局名称。

返回：

具有给定名称的内存布局。

参见：

• MemoryLayout.name() ^PREVIEW

withBitAlignment

GroupLayout PREVIEW  withBitAlignment(long bitAlignment)
            

返回与此布局具有相同大小和名称但具有指定对齐约束（以位为单位）的相同类型的内存布局。

指定者：

withBitAlignment 在接口 MemoryLayoutPREVIEW 中

参数：

bitAlignment - 布局对齐约束，以位表示。

返回：

具有给定对齐约束的内存布局。