Package com.singularsys.jep.parser

# Class JepJavaCharStream

java.lang.Object
com.singularsys.jep.parser.JepJavaCharStream

All Implemented Interfaces:
  `CharStream`

public class JepJavaCharStream extends Object implements CharStream
Customised version of the JavaCharStream. Only change is the error thrown by readChar() which is now a Localizable TokenMgrError rather than an Error.

- ## Field Summary

  Fields
  Modifier and Type
  Field
  Description
  `protected int[]`
  `bufcolumn`
  `protected char[]`
  `buffer`
  `protected int[]`
  `bufline`
  `int`
  `bufpos`
  Position in buffer.
  `protected int`
  `column`
  `protected int`
  `inBuf`
  `protected Reader`
  `inputStream`
  `protected int`
  `line`
  `protected int`
  `maxNextCharInd`
  `protected char[]`
  `nextCharBuf`
  `protected int`
  `nextCharInd`
  `protected boolean`
  `prevCharIsCR`
  `protected boolean`
  `prevCharIsLF`
  `static final boolean`
  `staticFlag`
  Whether parser is static.
  `protected int`
  `tabSize`
  `protected boolean`
  `trackLineColumn`

- ## Constructor Summary

  Constructors
  Constructor
  Description
  `JepJavaCharStream(InputStream dstream)`
  Constructor.
  `JepJavaCharStream(InputStream dstream, int startline, int startcolumn)`
  Constructor.
  `JepJavaCharStream(InputStream dstream, int startline, int startcolumn, int buffersize)`
  Constructor.
  `JepJavaCharStream(InputStream dstream, String encoding)`
  Constructor.
  `JepJavaCharStream(InputStream dstream, String encoding, int startline, int startcolumn)`
  Constructor.
  `JepJavaCharStream(InputStream dstream, String encoding, int startline, int startcolumn, int buffersize)`
  Constructor.
  `JepJavaCharStream(Reader dstream)`
  Constructor.
  `JepJavaCharStream(Reader dstream, int startline, int startcolumn)`
  Constructor.
  `JepJavaCharStream(Reader dstream, int startline, int startcolumn, int buffersize)`
  Constructor.

- ## Method Summary

  Modifier and Type
  Method
  Description
  `void`
  `adjustBeginLineColumn(int newLine, int newCol)`
  Method to adjust line and column numbers for the start of a token.
  `protected void`
  `AdjustBuffSize()`
  `void`
  `backup(int amount)`
  Retreat.
  `char`
  `BeginToken()`
  Returns the next character that marks the beginning of the next token.
  `void`
  `Done()`
  Set buffers back to null when finished.
  `protected void`
  `ExpandBuff(boolean wrapAround)`
  `protected void`
  `FillBuff()`
  `int`
  `getBeginColumn()`
  Returns the column number of the first character for current token (being matched after the last call to BeginTOken).
  `int`
  `getBeginLine()`
  Returns the line number of the first character for current token (being matched after the last call to BeginTOken).
  `int`
  `getColumn()`
  Deprecated.
  use `getEndColumn()`
  `int`
  `getEndColumn()`
  Get end column.
  `int`
  `getEndLine()`
  Get end line.
  `String`
  `GetImage()`
  Returns a string made up of characters from the marked token beginning to the current buffer position.
  `int`
  `getLine()`
  Deprecated.
  use `getEndLine()`.
  `char[]`
  `GetSuffix(int len)`
  Returns an array of characters that make up the suffix of length 'len' for the currently matched token.
  `int`
  `getTabSize()`
  `boolean`
  `getTrackLineColumn()`
  `protected char`
  `ReadByte()`
  `char`
  `readChar()`
  Read a character.
  `void`
  `ReInit(InputStream dstream)`
  Reinitialise.
  `void`
  `ReInit(InputStream dstream, int startline, int startcolumn)`
  Reinitialise.
  `void`
  `ReInit(InputStream dstream, int startline, int startcolumn, int buffersize)`
  Reinitialise.
  `void`
  `ReInit(InputStream dstream, String encoding)`
  Reinitialise.
  `void`
  `ReInit(InputStream dstream, String encoding, int startline, int startcolumn)`
  Reinitialise.
  `void`
  `ReInit(InputStream dstream, String encoding, int startline, int startcolumn, int buffersize)`
  Reinitialise.
  `void`
  `ReInit(Reader dstream)`
  Reinitialise.
  `void`
  `ReInit(Reader dstream, int startline, int startcolumn)`
  Reinitialise.
  `void`
  `ReInit(Reader dstream, int startline, int startcolumn, int buffersize)`
  Reinitialise.
  `void`
  `setTabSize(int i)`
  `void`
  `setTrackLineColumn(boolean trackLineColumn)`
  `protected void`
  `UpdateLineColumn(char c)`

  ### Methods inherited from class java.lang.Object

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

- ## Field Details

  - ### staticFlag

    public static final boolean staticFlag
    Whether parser is static.
    See Also:
      - Constant Field Values

  - ### bufpos

    public int bufpos
    Position in buffer.

  - ### bufline

    protected int[] bufline

  - ### bufcolumn

    protected int[] bufcolumn

  - ### column

    protected int column

  - ### line

    protected int line

  - ### prevCharIsCR

    protected boolean prevCharIsCR

  - ### prevCharIsLF

    protected boolean prevCharIsLF

  - ### inputStream

    protected Reader inputStream

  - ### nextCharBuf

    protected char[] nextCharBuf

  - ### buffer

    protected char[] buffer

  - ### maxNextCharInd

    protected int maxNextCharInd

  - ### nextCharInd

    protected int nextCharInd

  - ### inBuf

    protected int inBuf

  - ### tabSize

    protected int tabSize

  - ### trackLineColumn

    protected boolean trackLineColumn

- ## Constructor Details

  - ### JepJavaCharStream

    public JepJavaCharStream(Reader dstream, int startline, int startcolumn, int buffersize)
    Constructor.

  - ### JepJavaCharStream

    public JepJavaCharStream(Reader dstream, int startline, int startcolumn)
    Constructor.

  - ### JepJavaCharStream

    public JepJavaCharStream(Reader dstream)
    Constructor.

  - ### JepJavaCharStream

    public JepJavaCharStream(InputStream dstream, String encoding, int startline, int startcolumn, int buffersize) throws UnsupportedEncodingException
    Constructor.
    Throws:
      `UnsupportedEncodingException`

  - ### JepJavaCharStream

    public JepJavaCharStream(InputStream dstream, int startline, int startcolumn, int buffersize)
    Constructor.

  - ### JepJavaCharStream

    public JepJavaCharStream(InputStream dstream, String encoding, int startline, int startcolumn) throws UnsupportedEncodingException
    Constructor.
    Throws:
      `UnsupportedEncodingException`

  - ### JepJavaCharStream

    public JepJavaCharStream(InputStream dstream, int startline, int startcolumn)
    Constructor.

  - ### JepJavaCharStream

    public JepJavaCharStream(InputStream dstream, String encoding) throws UnsupportedEncodingException
    Constructor.
    Throws:
      `UnsupportedEncodingException`

  - ### JepJavaCharStream

    public JepJavaCharStream(InputStream dstream)
    Constructor.

- ## Method Details

  - ### setTabSize

    public void setTabSize(int i)
    Specified by:
      `setTabSize` in interface `CharStream`

  - ### getTabSize

    public int getTabSize()
    Specified by:
      `getTabSize` in interface `CharStream`

  - ### getTrackLineColumn

    public boolean getTrackLineColumn()
    Specified by:
      `getTrackLineColumn` in interface `CharStream`

  - ### setTrackLineColumn

    public void setTrackLineColumn(boolean trackLineColumn)
    Specified by:
      `setTrackLineColumn` in interface `CharStream`

  - ### ExpandBuff

    protected void ExpandBuff(boolean wrapAround)

  - ### FillBuff

    protected void FillBuff() throws IOException
    Throws:
      `IOException`

  - ### ReadByte

    protected char ReadByte() throws IOException
    Throws:
      `IOException`

  - ### BeginToken

    public char BeginToken() throws IOException
    Description copied from interface: `CharStream`
    Returns the next character that marks the beginning of the next token. All characters must remain in the buffer between two successive calls to this method to implement backup correctly.
    Specified by:
      `BeginToken` in interface `CharStream`
    Returns:
      starting character for token.
    Throws:
      `IOException`

  - ### AdjustBuffSize

    protected void AdjustBuffSize()

  - ### UpdateLineColumn

    protected void UpdateLineColumn(char c)

  - ### readChar

    public char readChar() throws IOException
    Read a character.
    Specified by:
      `readChar` in interface `CharStream`
    Throws:
      `IOException`

  - ### getColumn

    @Deprecated public int getColumn()
    Deprecated.
    use `getEndColumn()`
    Returns the column position of the character last read.
    Specified by:
      `getColumn` in interface `CharStream`

  - ### getLine

    @Deprecated public int getLine()
    Deprecated.
    use `getEndLine()`.
    Returns the line number of the character last read.
    Specified by:
      `getLine` in interface `CharStream`

  - ### getEndColumn

    public int getEndColumn()
    Get end column.
    Specified by:
      `getEndColumn` in interface `CharStream`

  - ### getEndLine

    public int getEndLine()
    Get end line.
    Specified by:
      `getEndLine` in interface `CharStream`

  - ### getBeginColumn

    public int getBeginColumn()
    Description copied from interface: `CharStream`
    Returns the column number of the first character for current token (being matched after the last call to BeginTOken).
    Specified by:
      `getBeginColumn` in interface `CharStream`
    Returns:
      column of token start

  - ### getBeginLine

    public int getBeginLine()
    Description copied from interface: `CharStream`
    Returns the line number of the first character for current token (being matched after the last call to BeginTOken).
    Specified by:
      `getBeginLine` in interface `CharStream`
    Returns:
      line number of token start

  - ### backup

    public void backup(int amount)
    Retreat.
    Specified by:
      `backup` in interface `CharStream`

  - ### ReInit

    public void ReInit(Reader dstream, int startline, int startcolumn, int buffersize)
    Reinitialise.

  - ### ReInit

    public void ReInit(Reader dstream, int startline, int startcolumn)
    Reinitialise.

  - ### ReInit

    public void ReInit(Reader dstream)
    Reinitialise.

  - ### ReInit

    public void ReInit(InputStream dstream, String encoding, int startline, int startcolumn, int buffersize) throws UnsupportedEncodingException
    Reinitialise.
    Throws:
      `UnsupportedEncodingException`

  - ### ReInit

    public void ReInit(InputStream dstream, int startline, int startcolumn, int buffersize)
    Reinitialise.

  - ### ReInit

    public void ReInit(InputStream dstream, String encoding, int startline, int startcolumn) throws UnsupportedEncodingException
    Reinitialise.
    Throws:
      `UnsupportedEncodingException`

  - ### ReInit

    public void ReInit(InputStream dstream, int startline, int startcolumn)
    Reinitialise.

  - ### ReInit

    public void ReInit(InputStream dstream, String encoding) throws UnsupportedEncodingException
    Reinitialise.
    Throws:
      `UnsupportedEncodingException`

  - ### ReInit

    public void ReInit(InputStream dstream)
    Reinitialise.

  - ### GetImage

    public String GetImage()
    Description copied from interface: `CharStream`
    Returns a string made up of characters from the marked token beginning to the current buffer position. Implementations have the choice of returning anything that they want to. For example, for efficiency, one might decide to just return null, which is a valid implementation.
    Specified by:
      `GetImage` in interface `CharStream`
    Returns:
      token image as String

  - ### GetSuffix

    public char[] GetSuffix(int len)
    Description copied from interface: `CharStream`
    Returns an array of characters that make up the suffix of length 'len' for the currently matched token. This is used to build up the matched string for use in actions in the case of MORE. A simple and inefficient implementation of this is as follows : { String t = GetImage(); return t.substring(t.length() - len, t.length()).toCharArray(); }
    Specified by:
      `GetSuffix` in interface `CharStream`
    Returns:
      suffix

  - ### Done

    public void Done()
    Set buffers back to null when finished.
    Specified by:
      `Done` in interface `CharStream`

  - ### adjustBeginLineColumn

    public void adjustBeginLineColumn(int newLine, int newCol)
    Method to adjust line and column numbers for the start of a token.