Package org.parboiled.buffers
Class DefaultInputBuffer
- java.lang.Object
-
- org.parboiled.buffers.DefaultInputBuffer
-
- All Implemented Interfaces:
InputBuffer
public class DefaultInputBuffer extends Object implements InputBuffer
Immutable default implementation of an InputBuffer.
-
-
Constructor Summary
Constructors Constructor Description DefaultInputBuffer(char[] buffer)
Constructs a new DefaultInputBuffer wrapping the given char array.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description char
charAt(int index)
Returns the character at the given index.String
extract(int start, int end)
Constructs a newString
from all character between the given indices.String
extract(IndexRange range)
Constructs a newString
from all character covered by the given IndexRange.String
extractLine(int lineNumber)
Constructs a newString
containing all characters with the given line number except for the trailing newline.int
getLineCount()
Returns the number of lines in the input buffer.int
getOriginalIndex(int index)
Translates the given index from the scope of this InputBuffer to the scope of the original, underlying char array.Position
getPosition(int index)
Returns the line and column number of the character with the given index encapsulated in aPosition
object.boolean
test(int index, char[] characters)
Determines whether the characters starting at the given index match the ones from the given array (in order).
-
-
-
Method Detail
-
charAt
public char charAt(int index)
Description copied from interface:InputBuffer
Returns the character at the given index. If the index is invalid the method returnsChars.EOI
.- Specified by:
charAt
in interfaceInputBuffer
- Parameters:
index
- the index- Returns:
- the character at the given index or Chars.EOI.
-
test
public boolean test(int index, char[] characters)
Description copied from interface:InputBuffer
Determines whether the characters starting at the given index match the ones from the given array (in order).- Specified by:
test
in interfaceInputBuffer
- Parameters:
index
- the index into the input buffer where to start the comparisoncharacters
- the characters to test against the input buffer- Returns:
- true if matched
-
extract
public String extract(int start, int end)
Description copied from interface:InputBuffer
Constructs a newString
from all character between the given indices. Invalid indices are automatically adjusted to their respective boundary.- Specified by:
extract
in interfaceInputBuffer
- Parameters:
start
- the start index (inclusively)end
- the end index (exclusively)- Returns:
- a new String (non-interned)
-
extract
public String extract(IndexRange range)
Description copied from interface:InputBuffer
Constructs a newString
from all character covered by the given IndexRange.- Specified by:
extract
in interfaceInputBuffer
- Parameters:
range
- the IndexRange- Returns:
- a new String (non-interned)
-
getPosition
public Position getPosition(int index)
Description copied from interface:InputBuffer
Returns the line and column number of the character with the given index encapsulated in aPosition
object. The very first character has the line number 1 and the column number 1.- Specified by:
getPosition
in interfaceInputBuffer
- Parameters:
index
- the index of the character to get the line number of- Returns:
- the line number
-
getOriginalIndex
public int getOriginalIndex(int index)
Description copied from interface:InputBuffer
Translates the given index from the scope of this InputBuffer to the scope of the original, underlying char array. TheDefaultInputBuffer
implementation simply returns the given index, but other implementations like theIndentDedentInputBuffer
or theMutableInputBuffer
need to "undo" all compressions and index shiftings performed internally in order to return the underlying index.- Specified by:
getOriginalIndex
in interfaceInputBuffer
- Parameters:
index
- the index relative to this InputBuffer- Returns:
- the index relative to the underlying string or char array
-
extractLine
public String extractLine(int lineNumber)
Description copied from interface:InputBuffer
Constructs a newString
containing all characters with the given line number except for the trailing newline.- Specified by:
extractLine
in interfaceInputBuffer
- Parameters:
lineNumber
- the line number to get- Returns:
- the string
-
getLineCount
public int getLineCount()
Description copied from interface:InputBuffer
Returns the number of lines in the input buffer.- Specified by:
getLineCount
in interfaceInputBuffer
- Returns:
- number of lines in the input buffer.
-
-