Module java.base

Package java.lang.foreign

Interface StructLayout

所有超级接口:

GroupLayout预览, MemoryLayout预览

       public sealed interface StructLayout extends GroupLayoutPREVIEW
      

StructLayout 是 Java 平台的预览 API。

仅当启用预览功能时，程序才能使用 StructLayout。

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

成员布局依次排列的组布局。

实现要求:

实现类是不可变的、线程安全的，并且是基于值的。

自 JDK 版本:

20

Nested Class Summary

Nested classes/interfaces declared in interface java.lang.foreign.MemoryLayout^PREVIEW

MemoryLayout.PathElementPREVIEW

Method Summary

Modifier and Type	Method	Description
StructLayoutPREVIEW	withByteAlignment(long byteAlignment)	返回一个具有与此布局相同特性的内存布局，但具有给定的对齐约束（以字节为单位）。
StructLayoutPREVIEW	withName(String name)	返回一个具有与此布局相同特性的内存布局，但具有给定的名称。
StructLayoutPREVIEW	withoutName()	返回一个具有与此布局相同特性的内存布局，但没有名称。

Methods declared in interface java.lang.foreign.GroupLayout^PREVIEW

memberLayouts

Methods declared in interface java.lang.foreign.MemoryLayout^PREVIEW

byteAlignment, byteOffset, byteOffsetHandle, byteSize, equals, hashCode, name, select, sliceHandle, toString, varHandle

Method Details

withName

             StructLayoutPREVIEW withName(String name)
            

返回一个具有与此布局相同特性的内存布局，但具有给定的名称。

指定者:

withName 在接口 GroupLayout预览 中

指定者:

withName 在接口 MemoryLayout预览 中

参数:

name - 布局名称。

返回:

一个具有与此布局相同特性的内存布局，但具有给定的名称

参见:

• MemoryLayout.name()^预览

withoutName

             StructLayoutPREVIEW withoutName()
            

返回一个具有与此布局相同特性的内存布局，但没有名称。

指定者:

withoutName 在接口 GroupLayout预览 中

指定者:

withoutName 在接口 MemoryLayout预览 中

返回:

一个具有与此布局相同特性的内存布局，但没有名称

参见:

• MemoryLayout.name()^预览

withByteAlignment

             StructLayoutPREVIEW withByteAlignment(long byteAlignment)
            

返回一个具有与此布局相同特性的内存布局，但具有给定的对齐约束（以字节为单位）。

指定者:

withByteAlignment 在接口 GroupLayout预览 中

指定者:

withByteAlignment 在接口 MemoryLayout预览 中

参数:

byteAlignment - 布局对齐约束，以字节表示。

返回:

一个具有与此布局相同特性的内存布局，但具有给定的对齐约束（以字节为单位）

抛出:

IllegalArgumentException - 如果 byteAlignment 不是 2 的幂。

IllegalArgumentException - 如果 byteAlignment 小于 M，其中 M 是与此组布局关联的任何成员布局中的最大对齐约束。