Package groovy.io
Class LineColumnReader
- java.lang.Object
-
- java.io.Reader
-
- java.io.BufferedReader
-
- groovy.io.LineColumnReader
-
- All Implemented Interfaces:
Closeable,AutoCloseable,Readable
public class LineColumnReader extends BufferedReader
TheLineColumnReaderis an extension toBufferedReaderthat keeps track of the line and column information of where the cursor is.- Since:
- 1.8.0
-
-
Constructor Summary
Constructors Constructor Description LineColumnReader(Reader reader)Constructor wrapping aReader(FileReader,FileReader,InputStreamReader, etc.)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidclose()Closes the stream and releases any system resources associated with it.longgetColumn()longgetColumnMark()longgetLine()longgetLineMark()voidmark(int readAheadLimit)Marks the present position in the stream.intread()Reads a single character.intread(char[] chars)Reads characters into an array.intread(char[] chars, int startOffset, int length)Reads characters into a portion of an array.intread(CharBuffer buffer)Not implemented.StringreadLine()Reads a line of text.voidreset()Resets the stream to the most recent mark.voidsetColumn(long column)voidsetColumnMark(long columnMark)voidsetLine(long line)voidsetLineMark(long lineMark)longskip(long toSkip)Skips characters.-
Methods inherited from class java.io.BufferedReader
lines, markSupported, ready
-
Methods inherited from class java.io.Reader
nullReader, transferTo
-
-
-
-
Constructor Detail
-
LineColumnReader
public LineColumnReader(Reader reader)
Constructor wrapping aReader(FileReader,FileReader,InputStreamReader, etc.)- Parameters:
reader- the reader to wrap
-
-
Method Detail
-
mark
public void mark(int readAheadLimit) throws IOExceptionMarks the present position in the stream. Subsequent calls to reset() will attempt to reposition the stream to this point.- Overrides:
markin classBufferedReader- Parameters:
readAheadLimit- Limit on the number of characters that may be read while still preserving the mark. An attempt to reset the stream after reading characters up to this limit or beyond may fail. A limit value larger than the size of the input buffer will cause a new buffer to be allocated whose size is no smaller than limit. Therefore large values should be used with care.- Throws:
IOException
-
reset
public void reset() throws IOExceptionResets the stream to the most recent mark.- Overrides:
resetin classBufferedReader- Throws:
IOException
-
read
public int read() throws IOExceptionReads a single character.- Overrides:
readin classBufferedReader- Returns:
- The character read, as an integer in the range 0 to 65535 (0x00-0xffff), or -1 if the end of the stream has been reached
- Throws:
IOException
-
read
public int read(char[] chars, int startOffset, int length) throws IOExceptionReads characters into a portion of an array.- Overrides:
readin classBufferedReader- Parameters:
chars- Destination array of charstartOffset- Offset at which to start storing characterslength- Maximum number of characters to read- Returns:
- an exception if an error occurs
- Throws:
IOException
-
readLine
public String readLine() throws IOException
Reads a line of text. A line is considered to be terminated by any one of a line feed ('\n'), a carriage return ('\r'), or a carriage return followed immediately by a linefeed.- Overrides:
readLinein classBufferedReader- Returns:
- A String containing the contents of the line, not including any line-termination characters, or null if the end of the stream has been reached
- Throws:
IOException
-
skip
public long skip(long toSkip) throws IOExceptionSkips characters.- Overrides:
skipin classBufferedReader- Parameters:
toSkip- the number of characters to skip- Returns:
- The number of characters actually skipped
- Throws:
IOException
-
read
public int read(char[] chars) throws IOExceptionReads characters into an array. This method will block until some input is available, an I/O error occurs, or the end of the stream is reached.- Overrides:
readin classReader- Parameters:
chars- Destination buffer- Returns:
- The number of characters read, or -1 if the end of the stream has been reached
- Throws:
IOException
-
read
public int read(CharBuffer buffer)
Not implemented.- Specified by:
readin interfaceReadable- Overrides:
readin classReader- Parameters:
buffer- Destination buffer- Returns:
- The number of characters read, or -1 if the end of the stream has been reached
- Throws:
UnsupportedOperationException- as the method is not implemented
-
close
public void close() throws IOExceptionCloses the stream and releases any system resources associated with it. Once the stream has been closed, further read(), ready(), mark(), reset(), or skip() invocations will throw an IOException. Closing a previously closed stream has no effect.- Specified by:
closein interfaceAutoCloseable- Specified by:
closein interfaceCloseable- Overrides:
closein classBufferedReader- Throws:
IOException
-
getColumn
public long getColumn()
-
setColumn
public void setColumn(long column)
-
getColumnMark
public long getColumnMark()
-
setColumnMark
public void setColumnMark(long columnMark)
-
getLine
public long getLine()
-
setLine
public void setLine(long line)
-
getLineMark
public long getLineMark()
-
setLineMark
public void setLineMark(long lineMark)
-
-