| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public class PushbackReader extends FilterReader
A character-stream reader that allows characters to be pushed back into the stream.
Field Summary |
---|
Fields inherited from class java.io.FilterReader |
---|
in |
Fields inherited from class java.io.Reader |
---|
lock |
Constructor Summary | |
---|---|
PushbackReader(Reader in) Creates a new pushback reader with a one-character pushback buffer. |
|
PushbackReader(Reader in, int size) Creates a new pushback reader with a pushback buffer of the given size. |
Method Summary | |
---|---|
void |
close() Closes the stream and releases any system resources associated with it. |
void |
mark(int readAheadLimit) Marks the present position in the stream. |
boolean |
Tells whether this stream supports the mark() operation, which it does not. |
int |
read() Reads a single character. |
int |
read(char[] cbuf, int off, int len) Reads characters into a portion of an array. |
boolean |
ready() Tells whether this stream is ready to be read. |
void |
reset() Resets the stream. |
long |
skip(long n) Skips characters. |
void |
unread(char[] cbuf) Pushes back an array of characters by copying it to the front of the pushback buffer. |
void |
unread(char[] cbuf, int off, int len) Pushes back a portion of an array of characters by copying it to the front of the pushback buffer. |
void |
unread(int c) Pushes back a single character by copying it to the front of the pushback buffer. |
Methods inherited from class java.io.FilterReader |
---|
close, mark, markSupported, read, read, ready, reset, skip |
Methods inherited from class java.io.Reader |
---|
close, mark, markSupported, read, read, read, read, ready, reset, skip |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public PushbackReader(Reader in)
in
- The reader from which characters will be readpublic PushbackReader(Reader in, int size)
in
- The reader from which characters will be readsize
- The size of the pushback bufferMethod Detail |
---|
public void close() throws IOException
close
in class FilterReader
IOException
- If an I/O error occurspublic void mark(int readAheadLimit) throws IOException
mark
for class PushbackReader
always throws an exception.
mark
in class FilterReader
readAheadLimit
IOException
- Always, since mark is not supportedpublic boolean markSupported()
markSupported
in class FilterReader
public int read() throws IOException
read
in class FilterReader
IOException
- If an I/O error occurspublic int read(char[] cbuf, int off, int len) throws IOException
read
in class FilterReader
cbuf
- Destination bufferoff
- Offset at which to start writing characterslen
- Maximum number of characters to readIOException
- If an I/O error occurspublic boolean ready() throws IOException
ready
in class FilterReader
IOException
- If an I/O error occurspublic void reset() throws IOException
reset
method of
PushbackReader
always throws an exception.
reset
in class FilterReader
IOException
- Always, since reset is not supportedpublic long skip(long n) throws IOException
skip
in class FilterReader
n
- The number of characters to skipIOException
- If an I/O error occurspublic void unread(char[] cbuf) throws IOException
cbuf[0]
, the character after that
will have the value cbuf[1]
, and so forth.
cbuf
- Character array to push backIOException
- If there is insufficient room in the pushback
buffer, or if some other I/O error occurspublic void unread(char[] cbuf, int off, int len) throws IOException
cbuf[off]
, the
character after that will have the value cbuf[off+1]
, and
so forth.
cbuf
- Character arrayoff
- Offset of first character to push backlen
- Number of characters to push backIOException
- If there is insufficient room in the pushback
buffer, or if some other I/O error occurspublic void unread(int c) throws IOException
(char)c
.
c
- The int value representing a character to be pushed backIOException
- If the pushback buffer is full,
or if some other I/O error occurs
| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |