Packageorg.antlr.runtime
Interfacepublic interface TokenStream extends IntStream
ImplementorsCommonTokenStream

A stream of tokens accessing tokens from a TokenSource



Public Properties
 PropertyDefined by
 Inheritedindex : int
Return the current input symbol index 0..n where n indicates the last symbol has been read.
IntStream
 Inheritedsize : int
Only makes sense for streams that buffer everything up probably, but might be useful to display the entire stream or for testing.
IntStream
 InheritedsourceName : String
Where are you getting symbols from? Normally, implementations will pass the buck all the way to the lexer who can ask its input stream for the file name or whatever.
IntStream
  tokenSource : TokenSource
[read-only] Where is this stream pulling tokens from? This is not the name, but the object that provides Token objects.
TokenStream
Public Methods
 MethodDefined by
 Inherited
consume():void
IntStream
  
getToken(i:int):Token
Get a token at an absolute index i; 0..n-1.
TokenStream
 Inherited
LA(i:int):int
Get int at current input pointer + i ahead where i=1 is next int.
IntStream
  
LT(k:int):Token
Get Token at current input pointer + i ahead where i=1 is next Token.
TokenStream
 Inherited
mark():int
Tell the stream to start buffering if it hasn't already.
IntStream
 Inherited
release(marker:int):void
You may want to commit to a backtrack but don't want to force the stream to keep bookkeeping objects around for a marker that is no longer necessary.
IntStream
 Inherited
rewind():void
Rewind to the input position of the last marker.
IntStream
 Inherited
rewindTo(marker:int):void
Reset the stream so that next call to index would return marker.
IntStream
 Inherited
seek(index:int):void
Set the input cursor to the position indicated by index.
IntStream
  
toStringWithRange(start:int, stop:int):String
Return the text of all tokens from start to stop, inclusive.
TokenStream
  
toStringWithTokenRange(start:Token, stop:Token):String
Because the user is not required to use a token with an index stored in it, we must provide a means for two token objects themselves to indicate the start/end location.
TokenStream
Property detail
tokenSourceproperty
tokenSource:TokenSource  [read-only]

Where is this stream pulling tokens from? This is not the name, but the object that provides Token objects.

Implementation
    public function get tokenSource():TokenSource
Method detail
getToken()method
public function getToken(i:int):Token

Get a token at an absolute index i; 0..n-1. This is really only needed for profiling and debugging and token stream rewriting. If you don't want to buffer up tokens, then this method makes no sense for you. Naturally you can't use the rewrite stream feature. I believe DebugTokenStream can easily be altered to not use this method, removing the dependency.

Parameters
i:int

Returns
Token
LT()method 
public function LT(k:int):Token

Get Token at current input pointer + i ahead where i=1 is next Token. i<0 indicates tokens in the past. So -1 is previous token and -2 is two tokens ago. LT(0) is undefined. For i>=n, return Token.EOFToken. Return null for LT(0) and any index that results in an absolute address that is negative.

Parameters
k:int

Returns
Token
toStringWithRange()method 
public function toStringWithRange(start:int, stop:int):String

Return the text of all tokens from start to stop, inclusive. If the stream does not buffer all the tokens then it can just return "" or null; Users should not access $ruleLabel.text in an action of course in that case.

Parameters
start:int
 
stop:int

Returns
String
toStringWithTokenRange()method 
public function toStringWithTokenRange(start:Token, stop:Token):String

Because the user is not required to use a token with an index stored in it, we must provide a means for two token objects themselves to indicate the start/end location. Most often this will just delegate to the other toString(int,int). This is also parallel with the TreeNodeStream.toString(Object,Object).

Parameters
start:Token
 
stop:Token

Returns
String