|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES All Classes | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object java.io.Reader java.io.FilterReader java.io.PushbackReader
public class PushbackReader
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)
Create a new pushback reader with a one-character pushback buffer. |
|
PushbackReader(Reader in,
int size)
Create a new pushback reader with a pushback buffer of the given size. |
Method Summary | |
---|---|
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, which it does not. |
int |
read()
Read a single character. |
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. |
void |
unread(char[] cbuf)
Push back an array of characters by copying it to the front of the pushback buffer. |
void |
unread(char[] cbuf,
int off,
int len)
Push back a portion of an array of characters by copying it to the front of the pushback buffer. |
void |
unread(int c)
Push back a single character. |
Methods inherited from class java.io.Reader |
---|
read, read |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public PushbackReader(Reader in, int size)
in
- The reader from which characters will be readsize
- The size of the pushback buffer
IllegalArgumentException
- if size is <= 0public PushbackReader(Reader in)
in
- The reader from which characters will be readMethod Detail |
---|
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 read
IOException
- If an I/O error occurspublic void unread(int c) throws IOException
c
- The character to push back
IOException
- If the pushback buffer is full,
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 back
IOException
- If there is insufficient room in the pushback
buffer, or if some other 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 back
IOException
- If there is insufficient room in the pushback
buffer, or if some other I/O error occurspublic boolean ready() throws IOException
ready
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
- 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
- Always, since mark is not supportedpublic void reset() throws IOException
reset
method of
PushbackReader
always throws an exception.
reset
in class FilterReader
IOException
- Always, since reset is not supportedpublic boolean markSupported()
markSupported
in class FilterReader
public void close() throws IOException
close
in interface Closeable
close
in class FilterReader
IOException
- If an I/O error occurspublic long skip(long n) throws IOException
skip
in class FilterReader
n
- The number of characters to skip
IllegalArgumentException
- If n
is negative.
IOException
- If an I/O error occurs
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES All Classes | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.