Package org.jparsec

Class ParseContext

java.lang.Object

org.jparsec.ParseContext

Direct Known Subclasses:

ParserState, ScannerState

abstract class ParseContext
extends Object

Represents the context state during parsing.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static enum	ParseContext.ErrorType
(package private) static interface	ParseContext.ParserTrace	Allows tracing of parsing progress during error condition, to ease debugging.

Field Summary

Fields

Modifier and Type	Field	Description
(package private) int	at	The current position of the input.
private int	currentErrorAt
private int	currentErrorIndex
private TreeNode	currentErrorNode
private ParseContext.ErrorType	currentErrorType
private String	encountered
(package private) static final String	EOF
private final ArrayList<Object>	errors
private boolean	errorSuppressed
(package private) final SourceLocator	locator
(package private) final String	module
private ParseContext.ErrorType	overrideErrorType
(package private) Object	result	The current parse result.
(package private) final CharSequence	source
(package private) int	step	The current logical step.
private ParseContext.ParserTrace	trace

Constructor Summary

Constructors

Constructor	Description
ParseContext(CharSequence source, int at, String module, SourceLocator locator)
ParseContext(CharSequence source, Object ret, int at, String module, SourceLocator locator)

Method Summary

Modifier and Type	Method	Description
(package private) final boolean	applyAsDelimiter(Parser<?> parser)	Runs parser with error recording suppressed.
(package private) final boolean	applyNested(Parser<?> parser, ParseContext nestedState)
(package private) final boolean	applyNewNode(Parser<?> parser, String name)	Applies parser as a new tree node with name, and if fails, reports "expecting $name".
(package private) final ParseTree	buildErrorParseTree()
(package private) final ParseTree	buildParseTree()
(package private) abstract CharSequence	characters()	Reads the characters as input.
private void	copyErrorFrom(ParseContext that)
(package private) final void	enableTrace(String rootName)	Enables parse tree tracing with rootName as the name of the root node.
(package private) final int	errorIndex()	The physical index of the current most relevant error, 0 if none.
(package private) final void	expected(Object what)
(package private) final void	fail(String message)
private String	getEncountered()
(package private) final int	getIndex()	Returns the current index in the original source.
(package private) abstract String	getInputName(int pos)	Returns the string representation of the current input (character or token).
(package private) abstract Token	getToken()	Returns the current token.
(package private) final ParseContext.ParserTrace	getTrace()
(package private) abstract boolean	isEof()
(package private) final void	missing(Object what)
(package private) final void	next()
(package private) final void	next(int n)
(package private) abstract char	peekChar()	Peeks the current character.
(package private) final void	raise(ParseContext.ErrorType type, Object subject)
(package private) final ParseErrorDetails	renderError()	Only called when rendering the error in ParserException.
(package private) final boolean	repeat(Parser<?> parser, int n)
(package private) final <T> boolean	repeat(Parser<? extends T> parser, int n, Collection<T> collection)
(package private) final void	set(int step, int at, Object ret)
(package private) final void	setAt(int step, int at)
private void	setErrorState(int errorAt, int errorIndex, ParseContext.ErrorType errorType)
private void	setErrorState(int errorAt, int errorIndex, ParseContext.ErrorType errorType, List<Object> errors)
(package private) final boolean	stillThere(int wasAt, int originalStep)
(package private) abstract int	toIndex(int pos)	Translates the logical position to physical index in the original source.
String	toString()
(package private) final void	unexpected(String what)
(package private) final boolean	withErrorSuppressed(Parser<?> parser)	Runs parser with error recording suppressed.

Methods inherited from class java.lang.Object

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

Field Details

EOF

static final String EOF

See Also:

• Constant Field Values

module

final String module

source

final CharSequence source

locator

final SourceLocator locator

at

int at

The current position of the input. Points to the token array for token level.

step

int step

The current logical step.

result

Object result

The current parse result.

trace

private ParseContext.ParserTrace trace

currentErrorType

private ParseContext.ErrorType currentErrorType

currentErrorAt

private int currentErrorAt

currentErrorIndex

private int currentErrorIndex

errors

private final ArrayList<Object> errors

encountered

private String encountered

currentErrorNode

private TreeNode currentErrorNode

errorSuppressed

private boolean errorSuppressed

overrideErrorType

private ParseContext.ErrorType overrideErrorType

Constructor Details

ParseContext

ParseContext(CharSequence source,
 int at,
 String module,
 SourceLocator locator)

ParseContext

ParseContext(CharSequence source,
 Object ret,
 int at,
 String module,
 SourceLocator locator)

Method Details

withErrorSuppressed

final boolean withErrorSuppressed(Parser<?> parser)

Runs parser with error recording suppressed.

applyAsDelimiter

final boolean applyAsDelimiter(Parser<?> parser)

Runs parser with error recording suppressed.

applyNewNode

final boolean applyNewNode(Parser<?> parser,
 String name)

Applies parser as a new tree node with name, and if fails, reports "expecting $name".

applyNested

final boolean applyNested(Parser<?> parser,
 ParseContext nestedState)

repeat

final boolean repeat(Parser<?> parser,
 int n)

repeat

final <T> boolean repeat(Parser<? extends T> parser,
 int n,
 Collection<T> collection)

getTrace

final ParseContext.ParserTrace getTrace()

errorIndex

final int errorIndex()

The physical index of the current most relevant error, 0 if none.

buildParseTree

final ParseTree buildParseTree()

buildErrorParseTree

final ParseTree buildErrorParseTree()

renderError

final ParseErrorDetails renderError()

Only called when rendering the error in ParserException.

getEncountered

private String getEncountered()

getInputName

abstract String getInputName(int pos)

Returns the string representation of the current input (character or token).

isEof

abstract boolean isEof()

getIndex

final int getIndex()

Returns the current index in the original source.

getToken

abstract Token getToken()

Returns the current token. Only applicable to token level parser.

peekChar

abstract char peekChar()

Peeks the current character. Only applicable to character level parser.

toIndex

abstract int toIndex(int pos)

Translates the logical position to physical index in the original source.

raise

final void raise(ParseContext.ErrorType type,
 Object subject)

fail

final void fail(String message)

missing

final void missing(Object what)

expected

final void expected(Object what)

unexpected

final void unexpected(String what)

stillThere

final boolean stillThere(int wasAt,
 int originalStep)

set

final void set(int step,
 int at,
 Object ret)

setAt

final void setAt(int step,
 int at)

next

final void next()

next

final void next(int n)

enableTrace

final void enableTrace(String rootName)

Enables parse tree tracing with rootName as the name of the root node.

setErrorState

private void setErrorState(int errorAt,
 int errorIndex,
 ParseContext.ErrorType errorType,
 List<Object> errors)

setErrorState

private void setErrorState(int errorAt,
 int errorIndex,
 ParseContext.ErrorType errorType)

copyErrorFrom

private void copyErrorFrom(ParseContext that)

characters

abstract CharSequence characters()

Reads the characters as input. Only applicable to character level parsers.

toString

public String toString()

Overrides:

toString in class Object