Class RubyRegexParser

java.lang.Object

com.oracle.truffle.regex.tregex.parser.flavors.RubyRegexParser

All Implemented Interfaces:

RegexParser, RegexValidator

public final class RubyRegexParser
extends Object
implements RegexValidator, RegexParser

Implements the parsing and validation of Ruby regular expressions.

Method Summary

Modifier and Type	Method	Description
static RegexParser	createParser(RegexLanguage language, RegexSource source, CompilationBuffer compilationBuffer)
static RegexValidator	createValidator(RegexSource source)
AbstractRegexObject	getFlags()	Returns a TruffleObject representing the compilation flags which were set for the regular expression.
AbstractRegexObject	getNamedCaptureGroups()	Returns a map from the names of capture groups to their indices.
boolean	isProperEscapeNext()	Indicates whether the following is a proper escape sequence, which cannot be a part of a string.
boolean	isQuantifierNext()	Indicates whether a quantifier is coming up next.
RegexAST	parse()	Runs the parser and produces an AST.
void	validate()	Checks the regular expression for syntax errors without building an AST.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

createValidator

public static RegexValidator createValidator(RegexSource source)
                                      throws RegexSyntaxException

Throws:

RegexSyntaxException

createParser

public static RegexParser createParser(RegexLanguage language,
 RegexSource source,
 CompilationBuffer compilationBuffer)
                                throws RegexSyntaxException

Throws:

RegexSyntaxException

getNamedCaptureGroups

public AbstractRegexObject getNamedCaptureGroups()

Description copied from interface: RegexParser

Returns a map from the names of capture groups to their indices. If the regular expression had no named capture groups, returns null. This method has to be called after calling RegexParser.parse().

Specified by:

getNamedCaptureGroups in interface RegexParser

getFlags

public AbstractRegexObject getFlags()

Description copied from interface: RegexParser

Returns a TruffleObject representing the compilation flags which were set for the regular expression. The returned object responds to 'READ' messages on names which correspond to the names of the flags as used in the language from which the flavor originates. This method has to be called after calling RegexParser.parse().

Specified by:

getFlags in interface RegexParser

validate

public void validate()
              throws RegexSyntaxException

Description copied from interface: RegexValidator

Checks the regular expression for syntax errors without building an AST.

Specified by:

validate in interface RegexValidator

Throws:

RegexSyntaxException - when the pattern or the flags are not well-formed

parse

public RegexAST parse()
               throws RegexSyntaxException,
UnsupportedRegexException

Description copied from interface: RegexParser

Runs the parser and produces an AST.

Specified by:

parse in interface RegexParser

Throws:

RegexSyntaxException - when the pattern or the flags are not well-formed

UnsupportedRegexException - when the pattern cannot be translated to an equivalent ECMAScript pattern

isProperEscapeNext

public boolean isProperEscapeNext()

Indicates whether the following is a proper escape sequence, which cannot be a part of a string. Those are all escape sequences with the difference of those handled by fetchEscapedChar().

isQuantifierNext

public boolean isQuantifierNext()

Indicates whether a quantifier is coming up next.