| java.lang.Object
 java.io.Reader
java.io.FilterReader
java.io.PushbackReader
| PushbackReader | | public class PushbackReader extends FilterReader (Code) | | A character-stream reader that allows characters to be pushed back into the
stream.
version:
1.27, 07/05/05
author:
Mark Reinhold
since:
JDK1.1 |
| Constructor Summary | |
| public | PushbackReader(Reader in, int size)
Creates a new pushback reader with a pushback buffer of the given size. | | public | PushbackReader(Reader in)
Creates a new pushback reader with a one-character pushback buffer. |
| Method Summary | |
| public void | close()
Closes the stream and releases any system resources associated with
it. | | public void | mark(int readAheadLimit)
Marks the present position in the stream. | | public boolean | markSupported()
Tells whether this stream supports the mark() operation, which it does
not. | | public int | read()
Reads a single character. | | public int | read(char cbuf, int off, int len)
Reads characters into a portion of an array. | | public boolean | ready()
Tells whether this stream is ready to be read. | | public void | reset()
Resets the stream. | | public long | skip(long n)
Skips characters. | | public void | unread(int c)
Pushes back a single character by copying it to the front of the
pushback buffer. | | public 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. | | public void | unread(char cbuf)
Pushes back an array of characters by copying it to the front of the
pushback buffer. |
| PushbackReader | | public PushbackReader(Reader in, int size)(Code) | | Creates a new pushback reader with a pushback buffer of the given size.
Parameters:
in - The reader from which characters will be read
Parameters:
size - The size of the pushback buffer
exception:
IllegalArgumentException - if size is <= 0 |
| PushbackReader | | public PushbackReader(Reader in)(Code) | | Creates a new pushback reader with a one-character pushback buffer.
Parameters:
in - The reader from which characters will be read |
| close | | public void close() throws IOException(Code) | | Closes the stream and releases any system resources associated with
it. Once the stream has been closed, further read(),
unread(), ready(), or skip() invocations will throw an IOException.
Closing a previously closed stream has no effect.
exception:
IOException - If an I/O error occurs |
| mark | | public void mark(int readAheadLimit) throws IOException(Code) | | Marks the present position in the stream. The mark
for class PushbackReader always throws an exception.
exception:
IOException - Always, since mark is not supported |
| markSupported | | public boolean markSupported()(Code) | | Tells whether this stream supports the mark() operation, which it does
not.
|
| read | | public int read() throws IOException(Code) | | Reads a single character.
The character read, or -1 if the end of the stream has beenreached
exception:
IOException - If an I/O error occurs |
| read | | public int read(char cbuf, int off, int len) throws IOException(Code) | | Reads characters into a portion of an array.
Parameters:
cbuf - Destination buffer
Parameters:
off - Offset at which to start writing characters
Parameters:
len - Maximum number of characters to read The number of characters read, or -1 if the end of thestream has been reached
exception:
IOException - If an I/O error occurs |
| ready | | public boolean ready() throws IOException(Code) | | Tells whether this stream is ready to be read.
exception:
IOException - If an I/O error occurs |
| reset | | public void reset() throws IOException(Code) | | Resets the stream. The reset method of
PushbackReader always throws an exception.
exception:
IOException - Always, since reset is not supported |
| skip | | public long skip(long n) throws IOException(Code) | | Skips characters. This method will block until some characters are
available, an I/O error occurs, or the end of the stream is reached.
Parameters:
n - The number of characters to skip The number of characters actually skipped
exception:
IllegalArgumentException - If n is negative.
exception:
IOException - If an I/O error occurs |
| unread | | public void unread(int c) throws IOException(Code) | | Pushes back a single character by copying it to the front of the
pushback buffer. After this method returns, the next character to be read
will have the value (char)c.
Parameters:
c - The int value representing a character to be pushed back
exception:
IOException - If the pushback buffer is full,or if some other I/O error occurs |
| unread | | public void unread(char cbuf, int off, int len) throws IOException(Code) | | Pushes back a portion of an array of characters by copying it to the
front of the pushback buffer. After this method returns, the next
character to be read will have the value cbuf[off], the
character after that will have the value cbuf[off+1], and
so forth.
Parameters:
cbuf - Character array
Parameters:
off - Offset of first character to push back
Parameters:
len - Number of characters to push back
exception:
IOException - If there is insufficient room in the pushbackbuffer, or if some other I/O error occurs |
| unread | | public void unread(char cbuf) throws IOException(Code) | | Pushes back an array of characters by copying it to the front of the
pushback buffer. After this method returns, the next character to be
read will have the value cbuf[0], the character after that
will have the value cbuf[1], and so forth.
Parameters:
cbuf - Character array to push back
exception:
IOException - If there is insufficient room in the pushbackbuffer, or if some other I/O error occurs |
|
|