|
Java™ Platform Standard Ed. 6 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectjava.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)
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 read| Method Detail |
|---|
public int read()
throws IOException
read in class FilterReaderIOException - If an I/O error occurs
public int read(char[] cbuf,
int off,
int len)
throws IOException
read in class FilterReadercbuf - Destination bufferoff - Offset at which to start writing characterslen - Maximum number of characters to read
IOException - If an I/O error occurs
public 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 occurs
public 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 occurs
public 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 occurs
public boolean ready()
throws IOException
ready in class FilterReaderIOException - If an I/O error occurs
public void mark(int readAheadLimit)
throws IOException
mark
for class PushbackReader always throws an exception.
mark in class FilterReaderreadAheadLimit - 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 supported
public void reset()
throws IOException
reset method of
PushbackReader always throws an exception.
reset in class FilterReaderIOException - Always, since reset is not supportedpublic boolean markSupported()
markSupported in class FilterReader
public void close()
throws IOException
close in interface Closeableclose in class FilterReaderIOException - If an I/O error occurs
public long skip(long n)
throws IOException
skip in class FilterReadern - 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 | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
Copyright © 1993, 2010, Oracle and/or its affiliates. All rights reserved.