|
Java™ Platform Standard Ed. 6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES All Classes | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object extended by java.io.Reader extended by java.io.FilterReader extended by 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)
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 |
markSupported()
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.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
(char)c
.
c
- The int value representing a character to be pushed 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
|
Java™ Platform Standard Ed. 6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES All Classes | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 1993, 2015, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.
Scripting on this page tracks web page traffic, but does not change the content in any way.