模块 java.base
包 java.lang.foreign

接口 ValueLayout.OfAddress

所有父级接口：
MemoryLayoutPREVIEW , ValueLayoutPREVIEW
封闭接口：
ValueLayoutPREVIEW
public static sealed interface ValueLayout.OfAddress extends ValueLayout PREVIEW
OfAddress 是 Java 平台的预览 API。
程序只能在启用预览功能时使用 OfAddress。
预览功能可能会在未来的版本中删除，或升级为 Java 平台的永久功能。
载体为 MemorySegment.class 的值布局。
自从：
19
参见：

  • 方法详情

    • withName

      ValueLayout.OfAddress PREVIEW  withName(String  name)
      返回与此布局具有相同大小和对齐约束但具有指定名称的相同类型的内存布局。
      指定者：
      withName 在接口 MemoryLayoutPREVIEW 中
      指定者：
      withName 在接口 ValueLayoutPREVIEW 中
      参数：
      name - 布局名称。
      返回：
      具有给定名称的内存布局。
      参见：

    • withBitAlignment

      ValueLayout.OfAddress PREVIEW  withBitAlignment(long bitAlignment)
      返回与此布局具有相同大小和名称但具有指定对齐约束（以位为单位）的相同类型的内存布局。
      指定者：
      withBitAlignment 在接口 MemoryLayoutPREVIEW 中
      指定者：
      withBitAlignment 在接口 ValueLayoutPREVIEW 中
      参数：
      bitAlignment - 布局对齐约束，以位表示。
      返回：
      具有给定对齐约束的内存布局。

    • withOrder

      ValueLayout.OfAddress PREVIEW  withOrder(ByteOrder  order)
      返回与此值布局具有相同载体、对齐约束和名称但具有指定字节顺序的值布局。
      指定者：
      withOrder 在接口 ValueLayoutPREVIEW 中
      参数：
      order - 所需的字节顺序。
      返回：
      具有给定字节顺序的值布局。

    • asUnbounded

      ValueLayout.OfAddress PREVIEW  asUnbounded()
      返回一个 unbounded 地址布局，其载体、对齐约束、名称和顺序与此地址布局相同，但具有指定的指针布局。无限制的地址布局允许原始地址作为内存段访问PREVIEW 其大小设置为 Long.MAX_VALUE 。因此，这些段可用于后续访问操作。

      这个方法是restricted 。受限方法是不安全的，如果使用不当，它们的使用可能会使 JVM 崩溃，或者更糟的是，无声地导致内存损坏。因此，客户应避免依赖受限的方法，并尽可能使用安全和受支持的功能。

      返回：
      与此布局具有相同特征的无界地址布局。
      抛出：
      IllegalCallerException - 如果调用者所在的模块未启用本机访问。
      参见：

    • isUnbounded

      boolean isUnbounded()
      返回 true ，如果此地址布局是 无界地址布局 ..
      返回：
      true ，如果此地址布局是 无界地址布局