All Packages Class Hierarchy This Package Previous Next Index
Class java.io.LineNumberReader
java.lang.Object
|
+----java.io.Reader
|
+----java.io.BufferedReader
|
+----java.io.LineNumberReader
- public class LineNumberReader
- extends BufferedReader
A buffered character-input stream that keeps track of line numbers. 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.
- LineNumberReader(Reader)
- Create a new line-numbering reader, using the default input-buffer size.
- LineNumberReader(Reader, int)
- Create a new line-numbering reader, reading characters into a buffer of the given size.
- getLineNumber()
- Get the current line number.
- mark(int)
- Mark the present position in the stream.
- read()
- Read a single character.
- read(char[], int, int)
- Read characters into a portion of an array.
- readLine()
- Read a line of text.
- reset()
- Reset the stream to the most recent mark.
- setLineNumber(int)
- Set the current line number.
- skip(long)
- Skip characters.
LineNumberReader
public LineNumberReader(Reader in)
- Create a new line-numbering reader, using the default input-buffer size.
LineNumberReader
public LineNumberReader(Reader in,
int sz)
- Create a new line-numbering reader, reading characters into a buffer of the given size.
setLineNumber
public void setLineNumber(int lineNumber)
- Set the current line number.
getLineNumber
public int getLineNumber()
- Get the current line number.
read
public int read() throws IOException
- Read a single character. Line terminators are compressed into single newline ('\n') characters.
- Returns:
- The character read, or -1 if the end of the stream has been reached
- Throws: IOException
- If an I/O error occurs
- Overrides:
- read in class BufferedReader
read
public int read(char cbuf[],
int off,
int len) throws IOException
- Read characters into a portion of an array.
- Parameters:
- cbuf - Destination buffer
- off - Offset at which to start storing characters
- len - Maximum number of characters to read
- Returns:
- The number of bytes read, or -1 if the end of the stream has already been reached
- Throws: IOException
- If an I/O error occurs
- Overrides:
- read in class BufferedReader
readLine
public String readLine() throws IOException
- Read 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.
- 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
- If an I/O error occurs
- Overrides:
- readLine in class BufferedReader
skip
public long skip(long n) throws IOException
- Skip characters.
- Parameters:
- n - The number of characters to skip
- Returns:
- The number of characters actually skipped
- Throws: IOException
- If an I/O error occurs
- Overrides:
- skip in class BufferedReader
mark
public void mark(int readAheadLimit) throws IOException
- Mark the present position in the stream. Subsequent calls to reset() will attempt to reposition the stream to this point, and will also reset the line number appropriately.
- Parameters:
- readAheadLimit - Limit on the number of characters that may be read while still preserving the mark. After reading this many characters, attempting to reset the stream may fail.
- Throws: IOException
- If an I/O error occurs
- Overrides:
- mark in class BufferedReader
reset
public void reset() throws IOException
- Reset the stream to the most recent mark.
- Throws: IOException
- If the stream has not been marked, or if the mark has been invalidated
- Overrides:
- reset in class BufferedReader
All Packages Class Hierarchy This Package Previous Next Index
Submit a bug or feature - Version 1.1.8 of Java Platform API Specification
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.
Copyright 1995-1999 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.