The object used to synchronize operations on this Reader object. For efficiency's sake, a particular implementation of a character stream can choose to synchronize its operations on something other than instances of itself. Thus, any subclass should synchronize on the lock object, instead of using a synchronized method or the this object.

This constructor creates a Reader that synchronizes on the Reader itself, or in other words, on the this object.

lock

The object to use for synchronization.

This constructor creates a Reader that synchronizes on the given object.

IOException

If any kind of I/O error occurs.

This method closes the reader and releases any system resources associated with it.

A subclass of Reader must implement this method.

readAheadLimit

The maximum number of characters that can be read before the saved position becomes invalid.

IOException

If any kind of I/O error occurs.

This method tells this Reader object to remember its current position, so that the position can be restored by a call to the reset() method. The Reader can read readAheadLimit characters beyond the marked position before the mark becomes invalid.

The implementation of the mark() method in Reader simply throws an exception to indicate that the mark-and-reset functionality is not implemented. A subclass must override the method to provide the functionality.

true if this reader supports mark() and reset(); false otherwise.

This method returns a boolean value that indicates whether or not this object supports mark-and-reset functionality.

The markSupported() method in Reader always returns false. A subclass that implements the mark-and-reset functionality should override the method to return true.

The next character of data or -1 if the end of the stream is encountered.

IOException

If any kind of I/O error occurs.

This method reads the next character of input. The character is returned as an integer in the range 0x0000 to 0xFFFF. The method blocks until the character is read, the end of stream is encountered, or an exception is thrown.

The implementation of this method in Reader reads the character by calling read(cb, 0, 1), where cb is a character array, and returning cb[0]. Although it is not strictly necessary, a subclass that wants to provide efficient single-character reads should override this method.

cbuf

An array of characters to be filled from the stream.

The actual number of characters read or -1 if the end of the stream is encountered immediately.

IOException

If any kind of I/O error occurs.

This method reads characters of input to fill the given array by calling read(cbuf, 0, cbuf.length). The method blocks until some data is available.

A subclass does not usually need to override this method, as it can override read(char[], int, int) and have read(char[]) work automatically.

cbuf

An array of characters to be filled from the stream.

off

An offset into the array.

len

The number of characters to read.

The actual number of characters read or -1 if the end of the stream is encountered immediately.

IOException

If any kind of I/O error occurs.

This method reads up to len characters of input into the given array starting at index off. The method blocks until some data is available.

A subclass of Reader must implement this method.

A boolean value that indicates whether the reader is ready to be read.

IOException

If any kind of I/O error occurs.

This method returns true if the next read() is guaranteed to not block.

The implementation of the ready() method in Reader always returns false. A subclass should override this method as appropriate.

IOException

If there was no previous call to the mark() method or the saved position has been invalidated.

This method restores the position of the stream to the position that was saved by a previous call to mark().

The implementation of the reset() method in Reader throws an exception to indicate that mark-and-reset functionality is not supported by default. A subclass must override the method to provide the functionality.

n

The number of characters to skip.

The actual number of characters skipped.

IOException

If any kind of I/O error occurs.

This method skips n characters of input. In other words, it moves the position of the stream forward by n characters.

The implementation of the skip() method in Reader simply calls read(cb, 0, n) where cb is a character array that is at least n bytes long. A subclass may want to override this method to implement a more efficient skipping algorithm.