Module com.maroontress.clione

Package com.maroontress.clione.impl

Class PhaseTwoSource

java.lang.Object

com.maroontress.clione.impl.PhaseTwoSource

All Implemented Interfaces:

Source

public final class PhaseTwoSource
extends Object
implements Source

This source reads characters from upstream source, splicing lines ended with the backslash (\).

Constructor Summary

Constructors

Constructor	Description
PhaseTwoSource(Source source)	Creates a source splicing lines.

Method Summary

Modifier and Type	Method	Description
void	close()	Closes this source and its upstream Source or Reader.
SourceChar	getChar()	Returns a new SourceChar object at the current location of this source or EOF.
SourceLocation	getLocation()	Returns the current location of this source.
void	ungetChar(SourceChar c)	Pushes back the specified SourceChar object.

Methods inherited from class java.lang.Object

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

Constructor Details

PhaseTwoSource

public PhaseTwoSource(Source source)

Creates a source splicing lines.

Parameters:

source - The upstream source.

Method Details

close

public void close()
           throws IOException

Closes this source and its upstream Source or Reader.

Specified by:

close in interface Source

Throws:

IOException - If an I/O error occurs.

getLocation

public SourceLocation getLocation()

Returns the current location of this source.

Specified by:

getLocation in interface Source

Returns:

The current location.

getChar

public SourceChar getChar()
                   throws IOException

Returns a new SourceChar object at the current location of this source or EOF.

This method does not change the current location either if the return value represents EOF or is the object that has been pushed back. Otherwise, the current location proceeds the next one.

This method may read two or more characters from the upstream Source or Reader. It may also replace one or more SourceChar objects with another SourceChar object and return it.

The return value representing EOF may differ from SourceChar.STATIC_EOF. Do not compare it with SourceChar.STATIC_EOF, use SourceChar.isEof() method instead.

Specified by:

getChar in interface Source

Returns:

The new SourceChar object.

Throws:

IOException - If an I/O error occurs.

See Also:

• SourceChar.isEof()

ungetChar

public void ungetChar(SourceChar c)

Pushes back the specified SourceChar object.

The SourceChar object to push back must not represent EOF.

This method does not change the current location.

Specified by:

ungetChar in interface Source

Parameters:

c - The SourceChar object to push back.