Annotation Interface HostCompilerDirectives.BytecodeInterpreterHandlerConfig.Argument

Enclosing class:

HostCompilerDirectives.BytecodeInterpreterHandlerConfig

@Retention(RUNTIME)
@Target(METHOD)
public static @interface HostCompilerDirectives.BytecodeInterpreterHandlerConfig.Argument

Configuration for a bytecode interpreter handler argument.

Since:

25.1

See Also:

• HostCompilerDirectives.BytecodeInterpreterHandler

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	HostCompilerDirectives.BytecodeInterpreterHandlerConfig.Argument.ExpansionKind
static @interface	HostCompilerDirectives.BytecodeInterpreterHandlerConfig.Argument.Field	Configuration for an expanded field.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element	Description
HostCompilerDirectives.BytecodeInterpreterHandlerConfig.Argument.ExpansionKind	expand	Indicates that this argument will be expanded in a Truffle interpreter bytecode handler stub if its expansion kind is not HostCompilerDirectives.BytecodeInterpreterHandlerConfig.Argument.ExpansionKind.NONE.
HostCompilerDirectives.BytecodeInterpreterHandlerConfig.Argument.Field[]	fields	Indicates the fields to be expanded of this argument if its expansion kind is HostCompilerDirectives.BytecodeInterpreterHandlerConfig.Argument.ExpansionKind.MATERIALIZED.
boolean	nonNull	Indicates that this argument is always non-null.
boolean	returnValue	Indicates that this argument will be updated with the return value of the handler.

Element Details

returnValue

boolean returnValue

Indicates that this argument will be updated with the return value of the handler. The interpreter must store the handler result directly back to the logical local represented by this argument. Threaded handler stubs rely on that direct store shape to keep the local consistent when an exception unwinds before the normal return-value update path runs.

Default:

false

expand

HostCompilerDirectives.BytecodeInterpreterHandlerConfig.Argument.ExpansionKind expand

Indicates that this argument will be expanded in a Truffle interpreter bytecode handler stub if its expansion kind is not HostCompilerDirectives.BytecodeInterpreterHandlerConfig.Argument.ExpansionKind.NONE.

Default:

NONE

fields

HostCompilerDirectives.BytecodeInterpreterHandlerConfig.Argument.Field[] fields

Indicates the fields to be expanded of this argument if its expansion kind is HostCompilerDirectives.BytecodeInterpreterHandlerConfig.Argument.ExpansionKind.MATERIALIZED.

Default:

{}

nonNull

boolean nonNull

Indicates that this argument is always non-null. A null check will be placed before the call site and before threading dispatch. This property is irrelevant for primitive arguments.

Default:

true