com.oracle.truffle.compiler

Interface TruffleCompilationSupport

public interface TruffleCompilationSupport

Represents entry points for Truffle runtime implementations to Truffle compilation.

Method Summary

Modifier and Type	Method and Description
boolean	compilerOptionExists(String key) Returns true if a compilation key exists, else false.
TruffleCompiler	createCompiler(TruffleCompilerRuntime runtime) Creates a new compiler handle for compilation.
String	getCompilerConfigurationName(TruffleCompilerRuntime runtime) Returns a compiler configuration name that will be used.
default boolean	isSuppressedCompilationFailure(Throwable throwable)
TruffleCompilerOptionDescriptor[]	listCompilerOptions() Lists all compiler options available, including deprecated options.
default AutoCloseable	openCompilerThreadScope() Opens a compiler thread scope for compilation threads.
void	registerRuntime(TruffleCompilerRuntime runtime) Registers a runtime instance after it was fully initialized.
String	validateCompilerOption(String key, String value) Validates a compiler option and returns null if the option is null.

Method Detail

registerRuntime

void registerRuntime(TruffleCompilerRuntime runtime)

Registers a runtime instance after it was fully initialized.

createCompiler

TruffleCompiler createCompiler(TruffleCompilerRuntime runtime)

Creates a new compiler handle for compilation. A runtime must be registered prior to calling this method. Only one compiler instance should be created per Truffle runtime instance.

listCompilerOptions

TruffleCompilerOptionDescriptor[] listCompilerOptions()

Lists all compiler options available, including deprecated options.

compilerOptionExists

boolean compilerOptionExists(String key)

Returns true if a compilation key exists, else false.

validateCompilerOption

String validateCompilerOption(String key,
                              String value)

Validates a compiler option and returns null if the option is null. An error message otherwise.

getCompilerConfigurationName

String getCompilerConfigurationName(TruffleCompilerRuntime runtime)

Returns a compiler configuration name that will be used.

openCompilerThreadScope

default AutoCloseable openCompilerThreadScope()

Opens a compiler thread scope for compilation threads. Use with try-with-resourcce.

isSuppressedCompilationFailure

default boolean isSuppressedCompilationFailure(Throwable throwable)