org.anarres.cpp

Class Source

java.lang.Object

org.anarres.cpp.Source

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, java.lang.Iterable<Token>

Direct Known Subclasses:

LexerSource

public abstract class Source
extends java.lang.Object
implements java.lang.Iterable<Token>, java.io.Closeable

An input to the Preprocessor. Inputs may come from Files, Strings or other sources. The preprocessor maintains a stack of Sources. Operations such as file inclusion or token pasting will push a new source onto the Preprocessor stack. Sources pop from the stack when they are exhausted; this may be transparent or explicit. BUG: Error messages are not handled properly.

Constructor Summary

Constructors

Constructor and Description
Source()

Method Summary

Modifier and Type	Method and Description
void	close()
protected void	error(int line, int column, java.lang.String msg)
int	getColumn() Returns the current column number within this Source.
int	getLine() Returns the current line number within this Source.
java.lang.String	getName() Returns the human-readable name of the current Source.
java.lang.String	getPath() Returns the File currently being lexed.
java.util.Iterator<Token>	iterator() Returns a token iterator for this Source.
void	setListener(PreprocessorListener pl) Sets the listener for this Source.
Token	skipline(boolean white) Skips tokens until the end of line.
abstract Token	token() Returns the next Token parsed from this input stream.
protected void	warning(int line, int column, java.lang.String msg)

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

Source

public Source()

Method Detail

setListener

public void setListener(PreprocessorListener pl)

Sets the listener for this Source. Normally this is set by the Preprocessor when a Source is used, but if you are using a Source as a standalone object, you may wish to call this.

getPath

@CheckForNull
public java.lang.String getPath()

Returns the File currently being lexed. If this Source is not a FileLexerSource, then it will ask the parent Source, and so forth recursively. If no Source on the stack is a FileLexerSource, returns null.

getName

@CheckForNull
public java.lang.String getName()

Returns the human-readable name of the current Source.

getLine

@Nonnegative
public int getLine()

Returns the current line number within this Source.

getColumn

public int getColumn()

Returns the current column number within this Source.

token

@Nonnull
public abstract Token token()
                              throws java.io.IOException,
                                     LexerException

Returns the next Token parsed from this input stream.

Throws:

java.io.IOException

LexerException

See Also:

Token

iterator

public java.util.Iterator<Token> iterator()

Returns a token iterator for this Source.

Specified by:

iterator in interface java.lang.Iterable<Token>

skipline

@Nonnull
public Token skipline(boolean white)
                        throws java.io.IOException,
                               LexerException

Skips tokens until the end of line.

Parameters:

white - true if only whitespace is permitted on the remainder of the line.

Returns:

the NL token.

Throws:

java.io.IOException

LexerException

error

protected void error(int line,
                     int column,
                     java.lang.String msg)
              throws LexerException

Throws:

LexerException

warning

protected void warning(int line,
                       int column,
                       java.lang.String msg)
                throws LexerException

Throws:

LexerException

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Throws:

java.io.IOException