public final class RuntimeOptionParser extends Object
Modifier and Type | Class and Description |
---|---|
static interface |
RuntimeOptionParser.OptionsParsedListener |
Constructor and Description |
---|
RuntimeOptionParser() |
Modifier and Type | Method and Description |
---|---|
Optional<org.graalvm.compiler.options.OptionDescriptor> |
getDescriptor(String optionName) |
Collection<org.graalvm.compiler.options.OptionDescriptor> |
getDescriptors() |
org.graalvm.compiler.options.OptionKey<?> |
lookupOption(String name,
Collection<org.graalvm.compiler.options.OptionDescriptor> fuzzyMatches) |
String[] |
parse(String[] args,
String optionPrefix)
Parses
args and sets/updates runtime option values for the elements matching a
runtime option. |
String[] |
parse(String[] args,
String optionPrefix,
SubstrateOptionsParser.BooleanOptionFormat booleanOptionFormat,
boolean systemExitOnError)
Parses
args and sets/updates runtime option values for the elements matching a
runtime option. |
static String[] |
parseAndConsumeAllOptions(String[] initialArgs)
Parse and consume all standard options and system properties supported by Substrate VM.
|
void |
registerOptionsParsedListener(RuntimeOptionParser.OptionsParsedListener listener) |
static RuntimeOptionParser |
singleton()
Returns the singleton instance that is created during native image generation and stored in
the
ImageSingletons . |
boolean |
updateRuntimeOptions(Set<org.graalvm.compiler.options.OptionDescriptor> newRuntimeOptions) |
public static String[] parseAndConsumeAllOptions(String[] initialArgs)
public Optional<org.graalvm.compiler.options.OptionDescriptor> getDescriptor(String optionName)
public boolean updateRuntimeOptions(Set<org.graalvm.compiler.options.OptionDescriptor> newRuntimeOptions)
public void registerOptionsParsedListener(RuntimeOptionParser.OptionsParsedListener listener)
public static RuntimeOptionParser singleton()
ImageSingletons
.public String[] parse(String[] args, String optionPrefix)
args
and sets/updates runtime option values for the elements matching a
runtime option. Arguments for boolean options are expected to be in
SubstrateOptionsParser.BooleanOptionFormat.PLUS_MINUS
format.args
- arguments to be parsedoptionPrefix
- prefix for the optionsargs
that do not match any runtime optionsIllegalArgumentException
- if an element in args
matches a runtime option but
has an invalid format. The parse error is described by
Throwable.getMessage()
.public String[] parse(String[] args, String optionPrefix, SubstrateOptionsParser.BooleanOptionFormat booleanOptionFormat, boolean systemExitOnError)
args
and sets/updates runtime option values for the elements matching a
runtime option.args
- arguments to be parsedoptionPrefix
- prefix for the optionssystemExitOnError
- determines whether to call System.exit(int)
if any element
in args
matches a runtime option but has an invalid formatargs
that do not match any runtime optionsIllegalArgumentException
- if an element in args
is invalid and
systemExitOnError == false
. The parse error is described by
Throwable.getMessage()
.public org.graalvm.compiler.options.OptionKey<?> lookupOption(String name, Collection<org.graalvm.compiler.options.OptionDescriptor> fuzzyMatches)
public Collection<org.graalvm.compiler.options.OptionDescriptor> getDescriptors()