public abstract class Reader extends Object
InputStreamReader
,
Writer
Modifier and Type | Field and Description |
---|---|
protected Object |
lock
The object used to synchronize operations on this stream.
|
Modifier | Constructor and Description |
---|---|
protected |
Reader()
Create a new character-stream reader whose critical sections will
synchronize on the reader itself.
|
protected |
Reader(Object lock)
Create a new character-stream reader whose critical sections will
synchronize on the given object.
|
Modifier and Type | Method and Description |
---|---|
abstract void |
close()
Close the stream.
|
void |
mark(int readAheadLimit)
Mark the present position in the stream.
|
boolean |
markSupported()
Tell whether this stream supports the mark() operation.
|
int |
read()
Read a single character.
|
int |
read(char[] cbuf)
Read characters into an array.
|
abstract int |
read(char[] cbuf,
int off,
int len)
Read characters into a portion of an array.
|
boolean |
ready()
Tell whether this stream is ready to be read.
|
void |
reset()
Reset the stream.
|
long |
skip(long n)
Skip characters.
|
protected Object lock
protected Reader()
protected Reader(Object lock)
lock
- The Object to synchronize on.public int read() throws IOException
Subclasses that intend to support efficient single-character input should override this method.
IOException
- If an I/O error occurspublic int read(char[] cbuf) throws IOException
cbuf
- Destination bufferIOException
- If an I/O error occurspublic abstract int read(char[] cbuf, int off, int len) throws IOException
cbuf
- Destination bufferoff
- Offset at which to start storing characterslen
- Maximum number of characters to readIOException
- If an I/O error occurspublic long skip(long n) throws IOException
n
- The number of characters to skipIllegalArgumentException
- If n
is negative.IOException
- If an I/O error occurspublic boolean ready() throws IOException
IOException
- If an I/O error occurspublic boolean markSupported()
public void mark(int readAheadLimit) throws IOException
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.IOException
- If the stream does not support mark(),
or if some other I/O error occurspublic void reset() throws IOException
IOException
- If the stream has not been marked,
or if the mark has been invalidated,
or if the stream does not support reset(),
or if some other I/O error occurspublic abstract void close() throws IOException
IOException
- If an I/O error occursCopyright © 2013, Oracle and/or its affiliates. All rights reserved.
Use is subject to License Terms. Your use of this web site or any of its contents or software indicates your agreement to be bound by these License Terms.