com.scriptbasic.readers

Class GenericReader

java.lang.Object

com.scriptbasic.readers.GenericReader

All Implemented Interfaces:

FactoryManaged, Reader, SourceLocationBound

public class GenericReader
extends Object
implements Reader

Constructor Summary

Constructors

Constructor and Description
GenericReader()

Method Summary

Methods

Modifier and Type	Method and Description
Integer	get() Get the next character from the input stream.
String	getFileName() Get the name of the file to which the object is bound to.
int	getLineNumber() Get the line number to which the object is bound to.
int	getPosition() Get the position on the line to which the object is bound to.
SourceProvider	getSourceProvider() Get the source provider that provided this reader.
void	pushBack(Integer ch) Readers should support lexical analyzers offering the possibility to push some characters back to the input stream, when a lexical analyzer can not decide its selection only consuming extra characters.
void	set(Reader sourceReader)
void	set(String sourceFileName)
void	setFactory(Factory factory) When a factory creates an instance of a class implementing this interface this method is called to register the factory that created the instance.
void	setSourceProvider(SourceProvider sourceProvider)

Methods inherited from class java.lang.Object

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

Constructor Detail

GenericReader

public GenericReader()

Method Detail

setFactory

public void setFactory(Factory factory)

Description copied from interface: FactoryManaged

When a factory creates an instance of a class implementing this interface this method is called to register the factory that created the instance.

Specified by:

setFactory in interface FactoryManaged

Parameters:

factory - the factory that manages the instance.

set

public void set(Reader sourceReader)

set

public void set(String sourceFileName)

Specified by:

set in interface Reader

getFileName

public String getFileName()

Description copied from interface: SourceLocationBound

Get the name of the file to which the object is bound to.

Specified by:

getFileName in interface SourceLocationBound

Returns:

the name of the file

getLineNumber

public int getLineNumber()

Description copied from interface: SourceLocationBound

Get the line number to which the object is bound to.

Specified by:

getLineNumber in interface SourceLocationBound

Returns:

the line number in the file

getPosition

public int getPosition()

Description copied from interface: SourceLocationBound

Get the position on the line to which the object is bound to.

Specified by:

getPosition in interface SourceLocationBound

Returns:

the position within the line

pushBack

public void pushBack(Integer ch)

Readers should support lexical analyzers offering the possibility to push some characters back to the input stream, when a lexical analyzer can not decide its selection only consuming extra characters.

Some of the readers may limit the operation of this push back functionality not supporting tracking line numbers, position and file name when this method is used.

Lexical analyzers should push back the characters that were read from the reader the backward order as they were read. (Read last pushed back first.)

Implementation should ignore null parameter. This implementation will not track the position properly when a new line character is pushed back

Specified by:

pushBack in interface Reader

Parameters:

ch - the character to push back

get

public Integer get()

Description copied from interface: Reader

Get the next character from the input stream.

Specified by:

get in interface Reader

Returns:

setSourceProvider

public void setSourceProvider(SourceProvider sourceProvider)

getSourceProvider

public SourceProvider getSourceProvider()

Description copied from interface: Reader

Get the source provider that provided this reader.

Specified by:

getSourceProvider in interface Reader

Returns:

the source provider object.