接口的使用
java.lang.foreign.MemorySegment

使用 MemorySegment 的包^PREVIEW

包	描述
java.lang.foreign	提供对 Java 运行时之外的内存和函数的低级访问。
java.nio.channels	定义通道，它表示与能够执行 I/O 操作的实体的连接，例如文件和套接字；定义选择器，用于多路复用、非阻塞 I/O 操作。
jdk.incubator.vector	孵化功能。 将在未来的版本中删除。

MemorySegment 的用法^PREVIEW 在java.lang.foreign

java.lang.foreign 中的字段声明为 MemorySegment^PREVIEW

修饰符和类型	Field	描述
static final MemorySegmentPREVIEW	MemorySegment.NULL	对 NULL 地址建模的零长度本机段。

java.lang.foreign 中返回 MemorySegment 的方法^PREVIEW

修饰符和类型	方法	描述
default MemorySegmentPREVIEW	Arena.allocate(long byteSize, long byteAlignment)	返回具有给定大小（以字节为单位）和对齐约束（以字节为单位）的本机内存段。
default MemorySegmentPREVIEW	SegmentAllocator.allocate(long byteSize)	分配给定大小的内存段。
MemorySegmentPREVIEW	SegmentAllocator.allocate(long byteSize, long byteAlignment)	分配具有给定大小和对齐约束的内存段。
default MemorySegmentPREVIEW	SegmentAllocator.allocate(MemoryLayoutPREVIEW layout)	分配具有给定布局的内存段。
default MemorySegmentPREVIEW	SegmentAllocator.allocate(ValueLayout.OfAddressPREVIEW layout, MemorySegmentPREVIEW value)	分配具有给定布局的内存段，并使用给定的地址值对其进行初始化。
default MemorySegmentPREVIEW	SegmentAllocator.allocate(ValueLayout.OfBytePREVIEW layout, byte value)	分配具有给定布局的内存段，并使用给定的字节值对其进行初始化。
default MemorySegmentPREVIEW	SegmentAllocator.allocate(ValueLayout.OfCharPREVIEW layout, char value)	分配具有给定布局的内存段并使用给定的 char 值对其进行初始化。
default MemorySegmentPREVIEW	SegmentAllocator.allocate(ValueLayout.OfDoublePREVIEW layout, double value)	分配具有给定布局的内存段，并使用给定的双精度值对其进行初始化。
default MemorySegmentPREVIEW	SegmentAllocator.allocate(ValueLayout.OfFloatPREVIEW layout, float value)	分配具有给定布局的内存段，并使用给定的浮点值对其进行初始化。
default MemorySegmentPREVIEW	SegmentAllocator.allocate(ValueLayout.OfIntPREVIEW layout, int value)	分配具有给定布局的内存段，并使用给定的 int 值对其进行初始化。
default MemorySegmentPREVIEW	SegmentAllocator.allocate(ValueLayout.OfLongPREVIEW layout, long value)	分配具有给定布局的内存段并使用给定的 long 值对其进行初始化。
default MemorySegmentPREVIEW	SegmentAllocator.allocate(ValueLayout.OfShortPREVIEW layout, short value)	分配具有给定布局的内存段并使用给定的短值对其进行初始化。
default MemorySegmentPREVIEW	SegmentAllocator.allocateArray(MemoryLayoutPREVIEW elementLayout, long count)	分配具有给定元素布局和大小的内存段。
default MemorySegmentPREVIEW	SegmentAllocator.allocateArray(ValueLayout.OfBytePREVIEW elementLayout, byte... elements)	分配具有给定布局的内存段，并使用给定的字节元素对其进行初始化。
default MemorySegmentPREVIEW	SegmentAllocator.allocateArray(ValueLayout.OfCharPREVIEW elementLayout, char... elements)	分配具有给定布局的内存段并使用给定的 char 元素对其进行初始化。
default MemorySegmentPREVIEW	SegmentAllocator.allocateArray(ValueLayout.OfDoublePREVIEW elementLayout, double... elements)	分配具有给定布局的内存段，并使用给定的双精度元素对其进行初始化。
default MemorySegmentPREVIEW	SegmentAllocator.allocateArray(ValueLayout.OfFloatPREVIEW elementLayout, float... elements)	分配具有给定布局的内存段，并使用给定的浮点元素对其进行初始化。
default MemorySegmentPREVIEW	SegmentAllocator.allocateArray(ValueLayout.OfIntPREVIEW elementLayout, int... elements)	分配具有给定布局的内存段，并使用给定的 int 元素对其进行初始化。
default MemorySegmentPREVIEW	SegmentAllocator.allocateArray(ValueLayout.OfLongPREVIEW elementLayout, long... elements)	分配具有给定布局的内存段，并使用给定的 long 元素对其进行初始化。
default MemorySegmentPREVIEW	SegmentAllocator.allocateArray(ValueLayout.OfShortPREVIEW elementLayout, short... elements)	分配具有给定布局的内存段，并使用给定的短元素对其进行初始化。
static MemorySegmentPREVIEW	MemorySegment.allocateNative(long byteSize, long byteAlignment, SegmentScopePREVIEW scope)	创建具有给定大小（以字节为单位）、对齐方式（以字节为单位）和范围的本机段。
static MemorySegmentPREVIEW	MemorySegment.allocateNative(long byteSize, SegmentScopePREVIEW scope)	创建具有给定大小（以字节为单位）和范围的本机段。
static MemorySegmentPREVIEW	MemorySegment.allocateNative(MemoryLayoutPREVIEW layout, SegmentScopePREVIEW scope)	创建具有给定布局和范围的本机段。
default MemorySegmentPREVIEW	SegmentAllocator.allocateUtf8String(String str)	将 Java 字符串转换为 UTF-8 编码、以 null 结尾的 C 字符串，并将结果存储到内存段中。
MemorySegmentPREVIEW	MemorySegment.asReadOnly()	返回此段的只读视图。
default MemorySegmentPREVIEW	MemorySegment.asSlice(long offset)	在给定的偏移量处返回此内存段的一片。
MemorySegmentPREVIEW	MemorySegment.asSlice(long offset, long newSize)	在给定的偏移量处返回此内存段的一片。
default MemorySegmentPREVIEW	MemorySegment.copyFrom(MemorySegmentPREVIEW src)	执行从给定源段到此段的批量复制。
MemorySegmentPREVIEW	MemorySegment.fill(byte value)	将值填充到此内存段中。
default MemorySegmentPREVIEW	MemorySegment.get(ValueLayout.OfAddressPREVIEW layout, long offset)	以给定的偏移量和给定的布局从该段中读取一个地址。
default MemorySegmentPREVIEW	MemorySegment.getAtIndex(ValueLayout.OfAddressPREVIEW layout, long index)	从给定索引处的给定段读取地址，按给定布局大小缩放。
MemorySegmentPREVIEW	VaList.nextVarg(GroupLayoutPREVIEW layout, SegmentAllocatorPREVIEW allocator)	将下一个复合值读入新的 MemorySegment ，使用提供的分配器分配，并推进此可变参数列表的位置。
MemorySegmentPREVIEW	VaList.nextVarg(ValueLayout.OfAddressPREVIEW layout)	读取下一个地址值，将其包装到本机段中，并推进此可变参数列表的位置。
static MemorySegmentPREVIEW	MemorySegment.ofAddress(long address)	从给定的 地址值 创建一个零长度的本地段PREVIEW .
static MemorySegmentPREVIEW	MemorySegment.ofAddress(long address, long byteSize)	创建具有给定大小和 地址值 的本机段PREVIEW .
static MemorySegmentPREVIEW	MemorySegment.ofAddress(long address, long byteSize, SegmentScopePREVIEW scope)	创建具有给定大小、地址和范围的本机段。
static MemorySegmentPREVIEW	MemorySegment.ofAddress(long address, long byteSize, SegmentScopePREVIEW scope, Runnable cleanupAction)	创建具有给定大小、地址和范围的本机段。
static MemorySegmentPREVIEW	MemorySegment.ofArray(byte[] byteArray)	创建由保存给定字节数组的堆上内存区域支持的堆段。
static MemorySegmentPREVIEW	MemorySegment.ofArray(char[] charArray)	创建一个由保存给定 char 数组的堆上内存区域支持的堆段。
static MemorySegmentPREVIEW	MemorySegment.ofArray(double[] doubleArray)	创建由保存给定双精度数组的堆上内存区域支持的堆段。
static MemorySegmentPREVIEW	MemorySegment.ofArray(float[] floatArray)	创建一个由保存给定浮点数组的堆上内存区域支持的堆段。
static MemorySegmentPREVIEW	MemorySegment.ofArray(int[] intArray)	创建由保存给定 int 数组的堆上内存区域支持的堆段。
static MemorySegmentPREVIEW	MemorySegment.ofArray(long[] longArray)	创建一个由保存给定长数组的堆上内存区域支持的堆段。
static MemorySegmentPREVIEW	MemorySegment.ofArray(short[] shortArray)	创建一个由保存给定短数组的堆上内存区域支持的堆段。
static MemorySegmentPREVIEW	MemorySegment.ofBuffer(Buffer buffer)	创建一个内存段，该内存段由支持给定 Buffer 实例的同一内存区域支持。
MemorySegmentPREVIEW	VaList.segment()	返回零长度 内存段PREVIEW 与此可变参数列表相关联。
MemorySegmentPREVIEW	Linker.upcallStub(MethodHandle target, FunctionDescriptorPREVIEW function, SegmentScopePREVIEW scope)	创建一个存根，它可以作为函数指针传递给其他外部函数，与给定范围相关联。

返回类型中包含 MemorySegment 类型参数的 java.lang.foreign 中的方法^PREVIEW

修饰符和类型	方法	描述
Optional<MemorySegmentPREVIEW>	MemorySegment.asOverlappingSlice(MemorySegmentPREVIEW other)	返回此片段的一部分，该片段是此片段与提供的片段之间的重叠部分。
Stream<MemorySegmentPREVIEW>	MemorySegment.elements(MemoryLayoutPREVIEW elementLayout)	返回此段中不相交切片（其大小与指定布局的大小匹配）的顺序 Stream。
Optional<MemorySegmentPREVIEW>	SymbolLookup.find(String name)	返回具有给定名称的符号的地址。
Spliterator<MemorySegmentPREVIEW>	MemorySegment.spliterator(MemoryLayoutPREVIEW elementLayout)	返回此内存段的拆分器。

java.lang.foreign 中的方法，参数类型为 MemorySegment^PREVIEW

修饰符和类型	方法	描述
VaList.BuilderPREVIEW	VaList.Builder.addVarg(GroupLayoutPREVIEW layout, MemorySegmentPREVIEW value)	将具有给定布局的 MemorySegment 写入正在构造的可变参数列表。
VaList.BuilderPREVIEW	VaList.Builder.addVarg(ValueLayout.OfAddressPREVIEW layout, MemorySegmentPREVIEW segment)	写入addressPREVIEW 提供的本机段到正在构造的变量参数列表。
default MemorySegmentPREVIEW	SegmentAllocator.allocate(ValueLayout.OfAddressPREVIEW layout, MemorySegmentPREVIEW value)	分配具有给定布局的内存段，并使用给定的地址值对其进行初始化。
Optional<MemorySegmentPREVIEW>	MemorySegment.asOverlappingSlice(MemorySegmentPREVIEW other)	返回此片段的一部分，该片段是此片段与提供的片段之间的重叠部分。
static void	MemorySegment.copy(MemorySegmentPREVIEW srcSegment, long srcOffset, MemorySegmentPREVIEW dstSegment, long dstOffset, long bytes)	执行从源段到目标段的批量复制。
static void	MemorySegment.copy(MemorySegmentPREVIEW srcSegment, ValueLayoutPREVIEW srcElementLayout, long srcOffset, MemorySegmentPREVIEW dstSegment, ValueLayoutPREVIEW dstElementLayout, long dstOffset, long elementCount)	执行从源段到目标段的批量复制。
static void	MemorySegment.copy(MemorySegmentPREVIEW srcSegment, ValueLayoutPREVIEW srcLayout, long srcOffset, Object dstArray, int dstIndex, int elementCount)	将多个元素从源内存段复制到目标数组。
static void	MemorySegment.copy(Object srcArray, int srcIndex, MemorySegmentPREVIEW dstSegment, ValueLayoutPREVIEW dstLayout, long dstOffset, int elementCount)	将多个元素从源数组复制到目标内存段。
default MemorySegmentPREVIEW	MemorySegment.copyFrom(MemorySegmentPREVIEW src)	执行从给定源段到此段的批量复制。
default MethodHandle	Linker.downcallHandle(MemorySegmentPREVIEW symbol, FunctionDescriptorPREVIEW function, Linker.OptionPREVIEW... options)	创建一个方法句柄，可用于调用具有给定签名和地址的外部函数。
default long	MemorySegment.mismatch(MemorySegmentPREVIEW other)	查找并返回此段与给定其他段之间第一个不匹配的偏移量（以字节为单位）。
static long	MemorySegment.mismatch(MemorySegmentPREVIEW srcSegment, long srcFromOffset, long srcToOffset, MemorySegmentPREVIEW dstSegment, long dstFromOffset, long dstToOffset)	查找并返回源段和目标段之间第一个不匹配的相对偏移量（以字节为单位）。
static SegmentAllocatorPREVIEW	SegmentAllocator.prefixAllocator(MemorySegmentPREVIEW segment)	返回一个段分配器，它通过回收单个段来响应分配请求。
long	MemorySegment.segmentOffset(MemorySegmentPREVIEW other)	返回提供的段相对于此段的偏移量（以字节为单位）。
default void	MemorySegment.set(ValueLayout.OfAddressPREVIEW layout, long offset, MemorySegmentPREVIEW value)	使用给定的布局在给定的偏移量处将地址写入此段。
default void	MemorySegment.setAtIndex(ValueLayout.OfAddressPREVIEW layout, long index, MemorySegmentPREVIEW value)	在给定索引处将地址写入此段，按给定布局大小缩放。
static SegmentAllocatorPREVIEW	SegmentAllocator.slicingAllocator(MemorySegmentPREVIEW segment)	返回一个段分配器，它通过返回从提供的段中获得的连续切片来响应分配请求。

MemorySegment 的用法^PREVIEW 在java.nio.channels

java.nio.channels 中返回 MemorySegment 的方法^PREVIEW

修饰符和类型	方法	描述
MemorySegmentPREVIEW	FileChannel.map(FileChannel.MapMode mode, long offset, long size, SegmentScopePREVIEW session)	预览。 将此通道文件的一个区域映射到一个新的映射内存段，具有给定的偏移量、大小和内存会话。

MemorySegment 的用法^PREVIEW 在jdk.incubator.vector

jdk.incubator.vector 中的方法，参数类型为 MemorySegment^PREVIEW

修饰符和类型	方法	描述
static ByteVector	ByteVector.fromMemorySegment(VectorSpecies<Byte> species, MemorySegmentPREVIEW ms, long offset, ByteOrder bo)	从 内存段 加载向量PREVIEW 从内存段的偏移量开始。
static ByteVector	ByteVector.fromMemorySegment(VectorSpecies<Byte> species, MemorySegmentPREVIEW ms, long offset, ByteOrder bo, VectorMask<Byte> m)	从 内存段 加载向量PREVIEW 从内存段的偏移量开始并使用掩码。
static DoubleVector	DoubleVector.fromMemorySegment(VectorSpecies<Double> species, MemorySegmentPREVIEW ms, long offset, ByteOrder bo)	从 内存段 加载向量PREVIEW 从内存段的偏移量开始。
static DoubleVector	DoubleVector.fromMemorySegment(VectorSpecies<Double> species, MemorySegmentPREVIEW ms, long offset, ByteOrder bo, VectorMask<Double> m)	从 内存段 加载向量PREVIEW 从内存段的偏移量开始并使用掩码。
static FloatVector	FloatVector.fromMemorySegment(VectorSpecies<Float> species, MemorySegmentPREVIEW ms, long offset, ByteOrder bo)	从 内存段 加载向量PREVIEW 从内存段的偏移量开始。
static FloatVector	FloatVector.fromMemorySegment(VectorSpecies<Float> species, MemorySegmentPREVIEW ms, long offset, ByteOrder bo, VectorMask<Float> m)	从 内存段 加载向量PREVIEW 从内存段的偏移量开始并使用掩码。
static IntVector	IntVector.fromMemorySegment(VectorSpecies<Integer> species, MemorySegmentPREVIEW ms, long offset, ByteOrder bo)	从 内存段 加载向量PREVIEW 从内存段的偏移量开始。
static IntVector	IntVector.fromMemorySegment(VectorSpecies<Integer> species, MemorySegmentPREVIEW ms, long offset, ByteOrder bo, VectorMask<Integer> m)	从 内存段 加载向量PREVIEW 从内存段的偏移量开始并使用掩码。
static LongVector	LongVector.fromMemorySegment(VectorSpecies<Long> species, MemorySegmentPREVIEW ms, long offset, ByteOrder bo)	从 内存段 加载向量PREVIEW 从内存段的偏移量开始。
static LongVector	LongVector.fromMemorySegment(VectorSpecies<Long> species, MemorySegmentPREVIEW ms, long offset, ByteOrder bo, VectorMask<Long> m)	从 内存段 加载向量PREVIEW 从内存段的偏移量开始并使用掩码。
static ShortVector	ShortVector.fromMemorySegment(VectorSpecies<Short> species, MemorySegmentPREVIEW ms, long offset, ByteOrder bo)	从 内存段 加载向量PREVIEW 从内存段的偏移量开始。
static ShortVector	ShortVector.fromMemorySegment(VectorSpecies<Short> species, MemorySegmentPREVIEW ms, long offset, ByteOrder bo, VectorMask<Short> m)	从 内存段 加载向量PREVIEW 从内存段的偏移量开始并使用掩码。
Vector<E>	VectorSpecies.fromMemorySegment(MemorySegmentPREVIEW ms, long offset, ByteOrder bo)	从 内存段 加载该物种的向量PREVIEW 从内存段的偏移量开始。
final void	ByteVector.intoMemorySegment(MemorySegmentPREVIEW ms, long offset, ByteOrder bo)	将此向量存储到 内存段PREVIEW 使用显式字节顺序从偏移量开始。
final void	ByteVector.intoMemorySegment(MemorySegmentPREVIEW ms, long offset, ByteOrder bo, VectorMask<Byte> m)	将此向量存储到 内存段PREVIEW 使用显式字节顺序和掩码从偏移量开始。
final void	DoubleVector.intoMemorySegment(MemorySegmentPREVIEW ms, long offset, ByteOrder bo)	将此向量存储到 内存段PREVIEW 使用显式字节顺序从偏移量开始。
final void	DoubleVector.intoMemorySegment(MemorySegmentPREVIEW ms, long offset, ByteOrder bo, VectorMask<Double> m)	将此向量存储到 内存段PREVIEW 使用显式字节顺序和掩码从偏移量开始。
final void	FloatVector.intoMemorySegment(MemorySegmentPREVIEW ms, long offset, ByteOrder bo)	将此向量存储到 内存段PREVIEW 使用显式字节顺序从偏移量开始。
final void	FloatVector.intoMemorySegment(MemorySegmentPREVIEW ms, long offset, ByteOrder bo, VectorMask<Float> m)	将此向量存储到 内存段PREVIEW 使用显式字节顺序和掩码从偏移量开始。
final void	IntVector.intoMemorySegment(MemorySegmentPREVIEW ms, long offset, ByteOrder bo)	将此向量存储到 内存段PREVIEW 使用显式字节顺序从偏移量开始。
final void	IntVector.intoMemorySegment(MemorySegmentPREVIEW ms, long offset, ByteOrder bo, VectorMask<Integer> m)	将此向量存储到 内存段PREVIEW 使用显式字节顺序和掩码从偏移量开始。
final void	LongVector.intoMemorySegment(MemorySegmentPREVIEW ms, long offset, ByteOrder bo)	将此向量存储到 内存段PREVIEW 使用显式字节顺序从偏移量开始。
final void	LongVector.intoMemorySegment(MemorySegmentPREVIEW ms, long offset, ByteOrder bo, VectorMask<Long> m)	将此向量存储到 内存段PREVIEW 使用显式字节顺序和掩码从偏移量开始。
final void	ShortVector.intoMemorySegment(MemorySegmentPREVIEW ms, long offset, ByteOrder bo)	将此向量存储到 内存段PREVIEW 使用显式字节顺序从偏移量开始。
final void	ShortVector.intoMemorySegment(MemorySegmentPREVIEW ms, long offset, ByteOrder bo, VectorMask<Short> m)	将此向量存储到 内存段PREVIEW 使用显式字节顺序和掩码从偏移量开始。
abstract void	Vector.intoMemorySegment(MemorySegmentPREVIEW ms, long offset, ByteOrder bo)	将此向量存储到 内存段PREVIEW 使用显式字节顺序从偏移量开始。
abstract void	Vector.intoMemorySegment(MemorySegmentPREVIEW ms, long offset, ByteOrder bo, VectorMask<E> m)	将此向量存储到 内存段PREVIEW 使用显式字节顺序和掩码从偏移量开始。