Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)

Summary: Inherited Fields | Ctors | Methods | Inherited Methods | [Expand All]

Added in API level 1

public class

LineNumberReader

extends BufferedReader

java.lang.Object
↳	java.io.Reader
	↳	java.io.BufferedReader
		↳	java.io.LineNumberReader

Class Overview

Wraps an existing Reader and counts the line terminators encountered while reading the data. The line number starts at 0 and is incremented any time '\r' , '\n' or "\r\n" is read. The class has an internal buffer for its data. The size of the buffer defaults to 8 KB.

Summary

[Expand]

Inherited Fields

From class java.io.Reader

Public Constructors
	LineNumberReader ( Reader in) Constructs a new LineNumberReader on the Reader `in` .
	LineNumberReader ( Reader in, int size) Constructs a new LineNumberReader on the Reader `in` .

Public Methods
int	getLineNumber () Returns the current line number for this reader.
void	mark (int readlimit) Sets a mark position in this reader.
int	read () Reads a single character from the source reader and returns it as an integer with the two higher-order bytes set to 0.
int	read (char[] buffer, int offset, int count) Reads up to `count` characters from the source reader and stores them in the character array `buffer` starting at `offset` .
String	readLine () Returns the next line of text available from this reader.
void	reset () Resets this reader to the last marked location.
void	setLineNumber (int lineNumber) Sets the line number of this reader to the specified `lineNumber` .
long	skip (long charCount) Skips `charCount` characters in this reader.

[Expand]

Inherited Methods

From class java.io.BufferedReader

void	close () Closes this reader.
void	mark (int markLimit) Sets a mark position in this reader.
boolean	markSupported () Indicates whether this reader supports the `mark()` and `reset()` methods.
int	read () Reads a single character from this reader and returns it with the two higher-order bytes set to 0.
int	read (char[] buffer, int offset, int length) Reads up to `length` characters from this reader and stores them at `offset` in the character array `buffer` .
String	readLine () Returns the next line of text available from this reader.
boolean	ready () Indicates whether this reader is ready to be read without blocking.
void	reset () Resets this reader's position to the last `mark()` location.
long	skip (long charCount) Skips at most `charCount` chars in this stream.

From class java.io.Reader

abstract void	close () Closes this reader.
void	mark (int readLimit) Sets a mark position in this reader.
boolean	markSupported () Indicates whether this reader supports the `mark()` and `reset()` methods.
int	read () Reads a single character from this reader and returns it as an integer with the two higher-order bytes set to 0.
abstract int	read (char[] buffer, int offset, int count) Reads up to `count` characters from this reader and stores them at `offset` in the character array `buffer` .
int	read ( CharBuffer target) Reads characters and puts them into the `target` character buffer.
int	read (char[] buffer) Reads characters from this reader and stores them in the character array `buffer` starting at offset 0.
boolean	ready () Indicates whether this reader is ready to be read without blocking.
void	reset () Resets this reader's position to the last `mark()` location.
long	skip (long charCount) Skips `charCount` characters in this reader.

From class java.lang.Object

Object	clone () Creates and returns a copy of this `Object` .
boolean	equals ( Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize () Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class <?>	getClass () Returns the unique instance of `Class` that represents this object's class.
int	hashCode () Returns an integer hash code for this object.
final void	notify () Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll () Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString () Returns a string containing a concise, human-readable description of this object.
final void	wait () Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait (long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait (long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

From interface java.io.Closeable

From interface java.lang.AutoCloseable

From interface java.lang.Readable

Public Constructors

public LineNumberReader ( Reader in)

Added in API level 1

Constructs a new LineNumberReader on the Reader in . The internal buffer gets the default size (8 KB).

Parameters

in	the Reader that is buffered.

public LineNumberReader ( Reader in, int size)

Added in API level 1

Constructs a new LineNumberReader on the Reader in . The size of the internal buffer is specified by the parameter size .

Parameters

in	the Reader that is buffered.
size	the size of the buffer to allocate.

Throws

IllegalArgumentException	if `size <= 0` .

Public Methods

public int getLineNumber ()

Added in API level 1

Returns the current line number for this reader. Numbering starts at 0.

Returns

the current line number.

public void mark (int readlimit)

Added in API level 1

Sets a mark position in this reader. The parameter readlimit indicates how many characters can be read before the mark is invalidated. Sending reset() will reposition this reader back to the marked position, provided that readlimit has not been surpassed. The line number associated with this marked position is also stored so that it can be restored when reset() is called.

Parameters

readlimit	the number of characters that can be read from this stream before the mark is invalidated.

Throws

IOException	if an error occurs while setting the mark in this reader.

public int read ()

Added in API level 1

Reads a single character from the source reader and returns it as an integer with the two higher-order bytes set to 0. Returns -1 if the end of the source reader has been reached.

The line number count is incremented if a line terminator is encountered. Recognized line terminator sequences are '\r' , '\n' and "\r\n" . Line terminator sequences are always translated into '\n' .

Returns

the character read or -1 if the end of the source reader has been reached.

Throws

IOException	if the reader is closed or another IOException occurs.

public int read (char[] buffer, int offset, int count)

Added in API level 1

Reads up to count characters from the source reader and stores them in the character array buffer starting at offset . Returns the number of characters actually read or -1 if no characters have been read and the end of this reader has been reached.

The line number count is incremented if a line terminator is encountered. Recognized line terminator sequences are '\r' , '\n' and "\r\n" .

Throws

IOException	if this reader is closed or another IOException occurs.

public String readLine ()

Added in API level 1

Returns the next line of text available from this reader. A line is represented by 0 or more characters followed by '\r' , '\n' , "\r\n" or the end of the stream. The returned string does not include the newline sequence.

Returns

the contents of the line or null if no characters have been read before the end of the stream has been reached.

Throws

IOException	if this reader is closed or another IOException occurs.

public void reset ()

Added in API level 1

Resets this reader to the last marked location. It also resets the line count to what is was when this reader was marked. This implementation resets the source reader.

Throws

IOException	if this reader is already closed, no mark has been set or the mark is no longer valid because more than `readlimit` bytes have been read since setting the mark.

public void setLineNumber (int lineNumber)

Added in API level 1

Sets the line number of this reader to the specified lineNumber . Note that this may have side effects on the line number associated with the last marked position.

Parameters

lineNumber	the new line number value.

public long skip (long charCount)

Added in API level 1

Skips charCount characters in this reader. Subsequent calls to read will not return these characters unless reset is used. This implementation skips charCount number of characters in the source reader and increments the line number count whenever line terminator sequences are skipped.

Returns

the number of characters actually skipped.

Throws

IllegalArgumentException	if `charCount < 0` .
IOException	if this reader is closed or another IOException occurs.

Results

Interfaces

Classes

Exceptions

Errors

LineNumberReader

Class Overview

Summary

Public Constructors

public LineNumberReader ( Reader in)

Parameters

public LineNumberReader ( Reader in, int size)

Parameters

Throws

Public Methods

public int getLineNumber ()

Returns

public void mark (int readlimit)

Parameters

Throws

See Also

public int read ()

Returns

Throws

public int read (char[] buffer, int offset, int count)

Throws

public String readLine ()

Returns

Throws

public void reset ()

Throws

See Also

public void setLineNumber (int lineNumber)

Parameters

See Also

public long skip (long charCount)

Returns

Throws

See Also