模块 java.base
包 java.lang.foreign

接口 Linker.Option

所有已知的子接口：
Linker.Option.CaptureCallStatePREVIEW
封闭接口：
LinkerPREVIEW
public static sealed interface Linker.Option permits Linker.Option.CaptureCallState PREVIEW (not exhaustive)
Option 是 Java 平台的预览 API。
程序只能在启用预览功能时使用 Option。
预览功能可能会在未来的版本中删除，或升级为 Java 平台的永久功能。
链接器选项用于指示链接器的附加链接要求，除了函数描述符所描述的内容之外。
自从：
20

  • 内部类总结

    内部类
    修饰符和类型
    接口
    描述
    static interface 
    Linker.Option.CaptureCallStatePREVIEW
    预览。
    一个链接器选项，用于在调用与向下调用方法句柄关联的外部函数之后立即保存部分执行状态，然后它可以被运行时覆盖，或通过常规方式读取。

  • 方法总结

    静态方法
    修饰符和类型
    方法
    描述
    static Linker.Option.CaptureCallStatePREVIEW
    captureCallState(String... capturedState)
    返回 一个链接器选项，用于在调用与向下调用方法句柄关联的外部函数之后立即保存部分执行状态，然后它可以被 Java 运行时覆盖或通过常规方式读取。
    static Linker.OptionPREVIEW
    firstVariadicArg(int index)
    返回一个链接器选项，用于表示外部函数调用中第一个可变参数布局的索引。

  • 方法详情

    • firstVariadicArg

      static Linker.Option PREVIEW  firstVariadicArg(int index)
      返回一个链接器选项，用于表示外部函数调用中第一个可变参数布局的索引。
      参数：
      index - downcall 句柄链接请求中第一个可变参数的索引。
      返回：
      一个链接器选项，用于表示外部函数调用中第一个可变参数布局的索引

    • captureCallState

      static Linker.Option.CaptureCallState PREVIEW  captureCallState(String ... capturedState)
      返回 一个链接器选项，用于在调用与向下调用方法句柄关联的外部函数之后立即保存部分执行状态，然后它可以被 Java 运行时覆盖或通过常规方式读取。

      与此选项链接的向下调用方法句柄将具有一个额外的MemorySegment PREVIEW 直接跟在目标地址后面的参数，可选SegmentAllocator PREVIEW 参数。该内存段必须是写入捕获状态的本机段。

      参数：
      capturedState - 要保存的值的名称。
      返回：
      一个链接器选项，用于在调用与向下调用方法句柄关联的外部函数之后立即保存部分执行状态，然后它可以被 Java 运行时覆盖，或通过常规方式读取
      参见：