TRegexOptions

java.lang.Object
- com.oracle.truffle.regex.tregex.TRegexOptions

public class TRegexOptions
extends Object

Field Summary

Fields
Modifier and Type	Field and Description
`static boolean`	`TRegexEnableNodeSplitter` Try to make control flow through DFAs reducible by node splitting (see `DFANodeSplit`).
`static boolean`	`TRegexEnableTraceFinder` Try to pre-calculate results of tree-like expressions (see `NFATraceFinderGenerator`).
`static int`	`TRegexGenerateDFAThresholdCalls` Number of regex searches done without generating a DFA for a given regular expression.
`static int`	`TRegexGenerateDFAThresholdCharacters` If a regex could have processed more than this number of characters without generating a fully expanded DFA, then we go ahead and generate the fully expanded DFA even before the `TRegexOptions.TRegexGenerateDFAThresholdCalls` threshold is met.
`static int`	`TRegexMaxBackTrackerMergeExplodeSize` Maximum number of `PureNFA` states allowed to be exploded in `TRegexBacktrackingNFAExecutorNode`.
`static int`	`TRegexMaxDFACGPartialTransitions` Bailout threshold for number of partial capture group transitions in the DFA (`TRegexDFAExecutorNode` generated by `DFAGenerator`).
`static int`	`TRegexMaxDFASize` Bailout threshold for number of nodes in the DFA (`TRegexDFAExecutorNode` generated by `DFAGenerator`).
`static int`	`TRegexMaxDFASizeAfterNodeSplitting` Maximum size of a DFA after being altered by `DFANodeSplit`.
`static int`	`TRegexMaxDFATransitions` Bailout threshold for number of transitions in the DFA (`TRegexDFAExecutorNode` generated by `DFAGenerator`).
`static int`	`TRegexMaxEagerCGDFACost` Maximum `capture group tracking cost` of eager capture group tracking DFA matchers.
`static int`	`TRegexMaxNFASize` Bailout threshold for number of nodes in the NFA (`NFA` generated by `NFAGenerator`).
`static int`	`TRegexMaxNumberOfASTSuccessorsInOneASTStep` Bailout threshold for number of ASTSuccessor instances allowed in a single `ASTStep`.
`static int`	`TRegexMaxNumberOfCaptureGroups` Bailout threshold for number of capture groups.
`static int`	`TRegexMaxNumberOfCaptureGroupsForDFA` Bailout threshold for number of capture groups in the DFA generator.
`static int`	`TRegexMaxNumberOfNFAStatesInOneDFATransition` Maximum number of NFA states involved in one DFA transition.
`static int`	`TRegexMaxParseTreeSizeForDFA` Parser trees bigger than this setting will not be considered for DFA generation.
`static int`	`TRegexMaxPureNFASize` Bailout threshold for number of nodes in the pure NFA (`PureNFA` generated by `PureNFAGenerator`).
`static int`	`TRegexMaxPureNFATransitions` Bailout threshold for number of transitions in the pure NFA (`PureNFA` generated by `PureNFAGenerator`).
`static int`	`TRegexMaxTransitionsInTrivialExecutor` Maximum number of `transitions` for a `TRegexExecutorNode` to be considered trivial.
`static int`	`TRegexParserTreeMaxNumberOfSequencesInGroup` Bailout threshold for number of `Sequence`s in a `Group`.
`static int`	`TRegexParserTreeMaxNumberOfTermsInSequence` Bailout threshold for number of `Term`s in a `Sequence`.
`static int`	`TRegexParserTreeMaxSize` Bailout threshold for number of nodes in the parser tree (`RegexAST` generated by `RegexASTBuilder`).
`static int`	`TRegexQuantifierUnrollThresholdGroup` The parser will try to unroll bounded quantifiers on groups up to this limit.
`static int`	`TRegexQuantifierUnrollThresholdSingleCC` The parser will try to unroll bounded quantifiers on single character classes up to this limit.
`static int`	`TRegexRangeToBitSetConversionThreshold` Minimum number of ranges that have the same high byte to convert into a bit set in a `RangeListMatcher` or `RangeTreeMatcher`.
`static int`	`TRegexTraceFinderMaxNumberOfResults` Maximum number of pre-calculated results per TraceFinder DFA.

Constructor Summary

Constructors
Constructor and Description

TRegexOptions()

Constructors
Constructor and Description
`TRegexOptions()`

Method Summary
- Methods inherited from class java.lang.Object
  clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - TRegexGenerateDFAThresholdCalls
```
public static final int TRegexGenerateDFAThresholdCalls
```
    Number of regex searches done without generating a DFA for a given regular expression. When this threshold is reached, TRegex tries to generate a fully expanded DFA to speed up further searches. This threshold is only checked in interpreter mode, so it should be sufficiently smaller than the Graal compilation threshold!
    
    See Also:
    
    Constant Field Values
  - TRegexGenerateDFAThresholdCharacters
```
public static final int TRegexGenerateDFAThresholdCharacters
```
    If a regex could have processed more than this number of characters without generating a fully expanded DFA, then we go ahead and generate the fully expanded DFA even before the TRegexOptions.TRegexGenerateDFAThresholdCalls threshold is met.
    
    See Also:
    
    Constant Field Values
  - TRegexEnableTraceFinder
```
public static final boolean TRegexEnableTraceFinder
```
    Try to pre-calculate results of tree-like expressions (see NFATraceFinderGenerator). A regular expression is considered tree-like if it does not contain infinite loops (+ or *). This option will increase performance at the cost of startup time and memory usage.
    
    See Also:
    
    Constant Field Values
  - TRegexTraceFinderMaxNumberOfResults
```
public static final int TRegexTraceFinderMaxNumberOfResults
```
    Maximum number of pre-calculated results per TraceFinder DFA. This number must not be higher than 254, because we compress the result indices to byte in TraceFinderDFAStateNode, with 255 being reserved for "no result"!
    
    See Also:
    
    Constant Field Values
  - TRegexEnableNodeSplitter
```
public static final boolean TRegexEnableNodeSplitter
```
    Try to make control flow through DFAs reducible by node splitting (see DFANodeSplit). This option will increase performance at the cost of startup time and memory usage.
    
    See Also:
    
    Constant Field Values
  - TRegexMaxDFASizeAfterNodeSplitting
```
public static final int TRegexMaxDFASizeAfterNodeSplitting
```
    Maximum size of a DFA after being altered by DFANodeSplit.
    
    See Also:
    
    Constant Field Values
  - TRegexRangeToBitSetConversionThreshold
```
public static final int TRegexRangeToBitSetConversionThreshold
```
    Minimum number of ranges that have the same high byte to convert into a bit set in a RangeListMatcher or RangeTreeMatcher. The threshold value must be greater than 1. Example:
```
     [က-ဠ], [ူ-၀], [ၐ-ၠ]
     are three ranges that have the same high byte (0x10).
     if TRegexRangeToBitSetConversionThreshold is <= 3, they will be converted to a
     bit set if they appear in a RangeList or RangeTree matcher.
 
```
    See Also:
    
    Constant Field Values
  - TRegexParserTreeMaxSize
```
public static final int TRegexParserTreeMaxSize
```
    Bailout threshold for number of nodes in the parser tree (RegexAST generated by RegexASTBuilder).
    
    See Also:
    
    Constant Field Values
  - TRegexParserTreeMaxNumberOfSequencesInGroup
```
public static final int TRegexParserTreeMaxNumberOfSequencesInGroup
```
    Bailout threshold for number of Sequences in a Group.
    
    See Also:
    
    Constant Field Values
  - TRegexParserTreeMaxNumberOfTermsInSequence
```
public static final int TRegexParserTreeMaxNumberOfTermsInSequence
```
    Bailout threshold for number of Terms in a Sequence.
    
    See Also:
    
    Constant Field Values
  - TRegexMaxParseTreeSizeForDFA
```
public static final int TRegexMaxParseTreeSizeForDFA
```
    Parser trees bigger than this setting will not be considered for DFA generation. The current setting is based on run times of graal/com.oracle.truffle.js.test/js/trufflejs/regexp/npm_extracted/hungry-regexp*.js
    
    See Also:
    
    Constant Field Values
  - TRegexMaxNFASize
```
public static final int TRegexMaxNFASize
```
    Bailout threshold for number of nodes in the NFA (NFA generated by NFAGenerator). This number must not be higher than Short.MAX_VALUE, because we use short values for indexing NFA nodes. The current setting is based on run times of graal/com.oracle.truffle.js.test/js/trufflejs/regexp/npm_extracted/hungry-regexp*.js
    
    See Also:
    
    Constant Field Values
  - TRegexMaxNumberOfASTSuccessorsInOneASTStep
```
public static final int TRegexMaxNumberOfASTSuccessorsInOneASTStep
```
    Bailout threshold for number of ASTSuccessor instances allowed in a single ASTStep. It is possible to construct patterns where the number of NFA transitions grows exponentially. ASTStep is an intermediate data structure between the AST and the NFA, which is filled eagerly and can cause an OutOfMemoryError if not capped. Since ASTSuccessors roughly correspond to NFA transitions, the cap has been set to the maximum number of NFA transitions we allow in a single NFA.
    
    See Also:
    
    Constant Field Values
  - TRegexMaxDFASize
```
public static final int TRegexMaxDFASize
```
    Bailout threshold for number of nodes in the DFA (TRegexDFAExecutorNode generated by DFAGenerator). This number must not be higher than Short.MAX_VALUE, because we use short values for indexing DFA nodes. The current setting is based on run times of graal/com.oracle.truffle.js.test/js/trufflejs/regexp/npm_extracted/hungry-regexp*.js
    
    See Also:
    
    Constant Field Values
  - TRegexMaxDFATransitions
```
public static final int TRegexMaxDFATransitions
```
    Bailout threshold for number of transitions in the DFA (TRegexDFAExecutorNode generated by DFAGenerator).
    
    See Also:
    
    Constant Field Values
  - TRegexMaxEagerCGDFACost
```
public static final int TRegexMaxEagerCGDFACost
```
    Maximum capture group tracking cost of eager capture group tracking DFA matchers.
    
    See Also:
    
    Constant Field Values
  - TRegexMaxDFACGPartialTransitions
```
public static final int TRegexMaxDFACGPartialTransitions
```
    Bailout threshold for number of partial capture group transitions in the DFA (TRegexDFAExecutorNode generated by DFAGenerator).
    
    See Also:
    
    Constant Field Values
  - TRegexQuantifierUnrollThresholdSingleCC
```
public static final int TRegexQuantifierUnrollThresholdSingleCC
```
    The parser will try to unroll bounded quantifiers on single character classes up to this limit.
    
    See Also:
    
    Constant Field Values
  - TRegexQuantifierUnrollThresholdGroup
```
public static final int TRegexQuantifierUnrollThresholdGroup
```
    The parser will try to unroll bounded quantifiers on groups up to this limit.
    
    See Also:
    
    Constant Field Values
  - TRegexMaxNumberOfCaptureGroups
```
public static final int TRegexMaxNumberOfCaptureGroups
```
    Bailout threshold for number of capture groups.
    
    See Also:
    
    Constant Field Values
  - TRegexMaxNumberOfCaptureGroupsForDFA
```
public static final int TRegexMaxNumberOfCaptureGroupsForDFA
```
    Bailout threshold for number of capture groups in the DFA generator. This number must not be higher than 127, because we compress capture group boundary indices to byte in DFACaptureGroupPartialTransition!
    
    See Also:
    
    Constant Field Values
  - TRegexMaxNumberOfNFAStatesInOneDFATransition
```
public static final int TRegexMaxNumberOfNFAStatesInOneDFATransition
```
    Maximum number of NFA states involved in one DFA transition. This number must not be higher than 255, because the maximum number of NFA states in one DFA transition determines the number of simultaneously tracked result sets (arrays) in capture group tracking mode, which are accessed over byte indices in DFACaptureGroupPartialTransition.
    
    See Also:
    
    Constant Field Values
  - TRegexMaxPureNFASize
```
public static final int TRegexMaxPureNFASize
```
    Bailout threshold for number of nodes in the pure NFA (PureNFA generated by PureNFAGenerator).
    
    See Also:
    
    Constant Field Values
  - TRegexMaxPureNFATransitions
```
public static final int TRegexMaxPureNFATransitions
```
    Bailout threshold for number of transitions in the pure NFA (PureNFA generated by PureNFAGenerator).
    
    See Also:
    
    Constant Field Values
  - TRegexMaxBackTrackerMergeExplodeSize
```
public static final int TRegexMaxBackTrackerMergeExplodeSize
```
    Maximum number of PureNFA states allowed to be exploded in TRegexBacktrackingNFAExecutorNode.
    
    See Also:
    
    Constant Field Values
  - TRegexMaxTransitionsInTrivialExecutor
```
public static final int TRegexMaxTransitionsInTrivialExecutor
```
    Maximum number of transitions for a TRegexExecutorNode to be considered trivial.
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - TRegexOptions
```
public TRegexOptions()
```

Class TRegexOptions

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

TRegexGenerateDFAThresholdCalls

TRegexGenerateDFAThresholdCharacters

TRegexEnableTraceFinder

TRegexTraceFinderMaxNumberOfResults

TRegexEnableNodeSplitter

TRegexMaxDFASizeAfterNodeSplitting

TRegexRangeToBitSetConversionThreshold

TRegexParserTreeMaxSize

TRegexParserTreeMaxNumberOfSequencesInGroup

TRegexParserTreeMaxNumberOfTermsInSequence

TRegexMaxParseTreeSizeForDFA

TRegexMaxNFASize

TRegexMaxNumberOfASTSuccessorsInOneASTStep

TRegexMaxDFASize

TRegexMaxDFATransitions

TRegexMaxEagerCGDFACost

TRegexMaxDFACGPartialTransitions

TRegexQuantifierUnrollThresholdSingleCC

TRegexQuantifierUnrollThresholdGroup

TRegexMaxNumberOfCaptureGroups

TRegexMaxNumberOfCaptureGroupsForDFA

TRegexMaxNumberOfNFAStatesInOneDFATransition

TRegexMaxPureNFASize

TRegexMaxPureNFATransitions

TRegexMaxBackTrackerMergeExplodeSize

TRegexMaxTransitionsInTrivialExecutor

Constructor Detail

TRegexOptions