Annotation Interface HostCompilerDirectives.BytecodeInterpreterHandler

Enclosing class:
HostCompilerDirectives

@Retention(RUNTIME) @Target(METHOD) public static @interface HostCompilerDirectives.BytecodeInterpreterHandler
Annotates a method that serves as a Truffle interpreter bytecode handler, that is, a method implements the complete semantics of a single bytecode instruction.

For more details, see the One Compilation per Bytecode Handler documentation.

Since:
25.1
  • Required Element Summary

    Required Elements
    Modifier and Type
    Required Element
    Description
    int[]
    The handled bytecode's opcodes.
  • Optional Element Summary

    Optional Elements
    Modifier and Type
    Optional Element
    Description
    boolean
    Indicates whether host safepoint should be inserted in the stub correspond to this handler.
    boolean
    Indicates whether to enable tail call threading at the end of this handler.
  • Element Details

    • value

      int[] value
      The handled bytecode's opcodes.
    • threading

      boolean threading
      Indicates whether to enable tail call threading at the end of this handler. If false, the threading will terminate, and control will return to the switch-loop after this handler is executed. Alternatively, omitting the HostCompilerDirectives.BytecodeInterpreterHandler annotation will cause control to return to the switch-loop before this handler is executed.
      Default:
      true
    • safepoint

      boolean safepoint
      Indicates whether host safepoint should be inserted in the stub correspond to this handler.
      Default:
      true