Module aya.ij.parsing.core

Package com.intellij.psi.builder

Class FleetPsiBuilder<N>

java.lang.Object

com.intellij.openapi.util.UserDataHolderBase

com.intellij.psi.builder.FleetPsiBuilder<N>

All Implemented Interfaces:

PsiBuilder, SyntaxTreeBuilder, com.intellij.openapi.util.UserDataHolder

Direct Known Subclasses:

MarkerPsiBuilder

public abstract class FleetPsiBuilder<N>
extends com.intellij.openapi.util.UserDataHolderBase
implements PsiBuilder

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	FleetPsiBuilder.ProductionMarker
static class	FleetPsiBuilder.StartMarker

Nested classes/interfaces inherited from interface com.intellij.lang.PsiBuilder

PsiBuilder.Marker

Field Summary

Fields

Modifier and Type	Field	Description
final ITokenSequence	myTokens

Constructor Summary

Constructors

Constructor	Description
FleetPsiBuilder(@NotNull CharSequence text, @NotNull ITokenSequence tokens, @NotNull TokenSet whitespaceTokens, @NotNull TokenSet commentTokens, int startLexeme, int lexemeCount)

Method Summary

Modifier and Type	Method	Description
void	advanceLexer()	Advances the lexer to the next token, skipping whitespace and comment tokens.
void	enforceCommentTokens(@NotNull TokenSet tokens)
final boolean	eof()	Checks if the lexer has reached the end of file.
void	error(@NotNull String messageText)	Adds an error marker with the specified message text at the current position in the tree.
int	getCurrentOffset()	Returns the start offset of the current token, or the file length when the token stream is over.
static @Nullable String	getErrorMessage(@NotNull LighterASTNode node)
@Nullable FleetPsiBuilder.StartMarker	getLatestDoneMarker()
@NotNull CharSequence	getOriginalText()	Returns the complete text being parsed.
@Nullable List<FleetPsiBuilder.ProductionMarker>	getProductions()
abstract N	getRoot()
@Nullable String	getTokenText()	Returns the text of the current token from the lexer.
@Nullable IElementType	getTokenType()	Returns the type of current token from the lexer.
boolean	isWhitespaceOrComment(@NotNull IElementType elementType)
@Nullable IElementType	lookAhead(int steps)	See what token type is in steps ahead.
@NotNull PsiBuilder.Marker	mark()	Creates a marker at the current parsing position.
IElementType	rawLookup(int steps)	See what token type is in steps ahead/behind.
int	rawTokenIndex()	Returns the index of the current token in the original sequence.
int	rawTokenTypeStart(int steps)	See what token type is in steps ahead/behind current position.
void	remapCurrentToken(IElementType type)	Slightly easier way to what ITokenTypeRemapper does (i.e.
void	setDebugMode(boolean dbgMode)	Enables or disables the builder debug mode.
void	setTokenTypeRemapper(ITokenTypeRemapper remapper)	Sets optional remapper that can change the type of tokens.
void	setWhitespaceSkippedCallback(@Nullable WhitespaceSkippedCallback callback)	Subscribe for notification on default whitespace and comments skipped events.
boolean	whitespaceOrComment(IElementType token)

Methods inherited from class com.intellij.openapi.util.UserDataHolderBase

getUserData, putUserData

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.intellij.lang.PsiBuilder

getTreeBuilt, getUserData, putUserData

Field Details

myTokens

public final ITokenSequence myTokens

Constructor Details

FleetPsiBuilder

public FleetPsiBuilder(@NotNull
 @NotNull CharSequence text,
 @NotNull
 @NotNull ITokenSequence tokens,
 @NotNull
 @NotNull TokenSet whitespaceTokens,
 @NotNull
 @NotNull TokenSet commentTokens,
 int startLexeme,
 int lexemeCount)

Method Details

getRoot

@NotNull
public abstract N getRoot()

isWhitespaceOrComment

public boolean isWhitespaceOrComment(@NotNull
 @NotNull IElementType elementType)

Specified by:

isWhitespaceOrComment in interface SyntaxTreeBuilder

enforceCommentTokens

public void enforceCommentTokens(@NotNull
 @NotNull TokenSet tokens)

Specified by:

enforceCommentTokens in interface SyntaxTreeBuilder

getLatestDoneMarker

@Nullable
public @Nullable FleetPsiBuilder.StartMarker getLatestDoneMarker()

Specified by:

getLatestDoneMarker in interface SyntaxTreeBuilder

Returns:

latest left done node for context dependent parsing.

getOriginalText

@NotNull
public @NotNull CharSequence getOriginalText()

Description copied from interface: SyntaxTreeBuilder

Returns the complete text being parsed.

Specified by:

getOriginalText in interface SyntaxTreeBuilder

Returns:

the text being parsed

getTokenType

@Nullable
public @Nullable IElementType getTokenType()

Description copied from interface: SyntaxTreeBuilder

Returns the type of current token from the lexer.

Specified by:

getTokenType in interface SyntaxTreeBuilder

Returns:

the token type, or null when the token stream is over.

setTokenTypeRemapper

public void setTokenTypeRemapper(ITokenTypeRemapper remapper)

Description copied from interface: SyntaxTreeBuilder

Sets optional remapper that can change the type of tokens. Output of SyntaxTreeBuilder.getTokenType() is affected by it.

Specified by:

setTokenTypeRemapper in interface SyntaxTreeBuilder

Parameters:

remapper - the remapper object, or null.

remapCurrentToken

public void remapCurrentToken(IElementType type)

Description copied from interface: SyntaxTreeBuilder

Slightly easier way to what ITokenTypeRemapper does (i.e. it just remaps current token to a given type).

Specified by:

remapCurrentToken in interface SyntaxTreeBuilder

Parameters:

type - new type for the current token.

lookAhead

@Nullable
public @Nullable IElementType lookAhead(int steps)

Description copied from interface: SyntaxTreeBuilder

See what token type is in steps ahead.

Specified by:

lookAhead in interface SyntaxTreeBuilder

Parameters:

steps - 0 is current token (i.e. the same SyntaxTreeBuilder.getTokenType() returns)

Returns:

type element which SyntaxTreeBuilder.getTokenType() will return if we call advance steps times in a row

rawLookup

public IElementType rawLookup(int steps)

Description copied from interface: SyntaxTreeBuilder

See what token type is in steps ahead/behind.

Specified by:

rawLookup in interface SyntaxTreeBuilder

Parameters:

steps - 0 is current token (i.e. the same SyntaxTreeBuilder.getTokenType() returns)

Returns:

type element ahead or behind, including whitespace/comment tokens

rawTokenTypeStart

public int rawTokenTypeStart(int steps)

Description copied from interface: SyntaxTreeBuilder

See what token type is in steps ahead/behind current position.

Specified by:

rawTokenTypeStart in interface SyntaxTreeBuilder

Parameters:

steps - 0 is current token (i.e. the same SyntaxTreeBuilder.getTokenType() returns)

Returns:

offset type element ahead or behind, including whitespace/comment tokens, -1 if first token, getOriginalText().getLength() at end

rawTokenIndex

public int rawTokenIndex()

Description copied from interface: SyntaxTreeBuilder

Returns the index of the current token in the original sequence.

Specified by:

rawTokenIndex in interface SyntaxTreeBuilder

Returns:

token index

setWhitespaceSkippedCallback

public void setWhitespaceSkippedCallback(@Nullable
 @Nullable WhitespaceSkippedCallback callback)

Description copied from interface: SyntaxTreeBuilder

Subscribe for notification on default whitespace and comments skipped events.

Specified by:

setWhitespaceSkippedCallback in interface SyntaxTreeBuilder

Parameters:

callback - an implementation for the callback

advanceLexer

public void advanceLexer()

Description copied from interface: SyntaxTreeBuilder

Advances the lexer to the next token, skipping whitespace and comment tokens.

Specified by:

advanceLexer in interface SyntaxTreeBuilder

getCurrentOffset

public int getCurrentOffset()

Description copied from interface: SyntaxTreeBuilder

Returns the start offset of the current token, or the file length when the token stream is over.

Specified by:

getCurrentOffset in interface SyntaxTreeBuilder

Returns:

the token offset.

getTokenText

@Nullable
public @Nullable String getTokenText()

Description copied from interface: SyntaxTreeBuilder

Returns the text of the current token from the lexer.

Specified by:

getTokenText in interface SyntaxTreeBuilder

Returns:

the token text, or null when the token stream is over.

whitespaceOrComment

public boolean whitespaceOrComment(IElementType token)

mark

@NotNull
public @NotNull PsiBuilder.Marker mark()

Description copied from interface: SyntaxTreeBuilder

Creates a marker at the current parsing position.

Specified by:

mark in interface PsiBuilder

Specified by:

mark in interface SyntaxTreeBuilder

Returns:

the new marker instance.

eof

public final boolean eof()

Description copied from interface: SyntaxTreeBuilder

Checks if the lexer has reached the end of file.

Specified by:

eof in interface SyntaxTreeBuilder

Returns:

true if the lexer is at end of file, false otherwise.

error

public void error(@NotNull
 @NotNull String messageText)

Description copied from interface: SyntaxTreeBuilder

Adds an error marker with the specified message text at the current position in the tree.
Note: from series of subsequent errors messages only first will be part of resulting tree.

Specified by:

error in interface SyntaxTreeBuilder

Parameters:

messageText - the text of the error message displayed to the user.

getErrorMessage

@Nullable
public static @Nullable String getErrorMessage(@NotNull
 @NotNull LighterASTNode node)

setDebugMode

public void setDebugMode(boolean dbgMode)

Description copied from interface: SyntaxTreeBuilder

Enables or disables the builder debug mode. In debug mode, the builder will print stack trace to marker allocation position if one is not done when calling #getTreeBuilt().

Specified by:

setDebugMode in interface SyntaxTreeBuilder

Parameters:

dbgMode - the debug mode value.

getProductions

@Nullable
public @Nullable List<FleetPsiBuilder.ProductionMarker> getProductions()