public class CharArrayReader extends Reader
This class implements a character buffer that can be used as a character-input stream.
protected char[] buf
The character buffer.
protected int pos
The current buffer position.
protected int markedPos
The position of mark in buffer.
protected int count
The index of the end of this buffer. There is not valid data at or beyond this index.
public CharArrayReader(char[] buf)
Creates a CharArrayReader from the specified array of chars.
buf
- Input buffer (not copied)public CharArrayReader(char[] buf, int offset, int length)
Creates a CharArrayReader from the specified array of chars.
The resulting reader will start reading at the given offset
. The total number of char
values that can be read from this reader will be either length
or buf.length-offset
, whichever is smaller.
buf
- Input buffer (not copied)offset
- Offset of the first char to readlength
- Number of chars to readIllegalArgumentException
- If offset
is negative or greater than buf.length
, or if length
is negative, or if the sum of these two values is negative.public int read() throws IOException
Reads a single character.
read
in class Reader
0x00-0xffff
), or -1 if the end of the stream has been reachedIOException
- If an I/O error occurspublic int read(char[] b, int off, int len) throws IOException
Reads characters into a portion of an array.
read
in class Reader
b
- Destination bufferoff
- Offset at which to start storing characterslen
- Maximum number of characters to readIOException
- If an I/O error occurspublic long skip(long n) throws IOException
Skips characters. Returns the number of characters that were skipped.
The n
parameter may be negative, even though the skip
method of the Reader
superclass throws an exception in this case. If n
is negative, then this method does nothing and returns 0
.
skip
in class Reader
n
- The number of characters to skipIOException
- If the stream is closed, or an I/O error occurspublic boolean ready() throws IOException
Tells whether this stream is ready to be read. Character-array readers are always ready to be read.
ready
in class Reader
IOException
- If an I/O error occurspublic boolean markSupported()
Tells whether this stream supports the mark() operation, which it does.
markSupported
in class Reader
public void mark(int readAheadLimit) throws IOException
Marks the present position in the stream. Subsequent calls to reset() will reposition the stream to this point.
mark
in class Reader
readAheadLimit
- Limit on the number of characters that may be read while still preserving the mark. Because the stream's input comes from a character array, there is no actual limit; hence this argument is ignored.IOException
- If an I/O error occurspublic void reset() throws IOException
Resets the stream to the most recent mark, or to the beginning if it has never been marked.
reset
in class Reader
IOException
- If an I/O error occurspublic void close()
Closes the stream and releases any system resources associated with it. Once the stream has been closed, further read(), ready(), mark(), reset(), or skip() invocations will throw an IOException. Closing a previously closed stream has no effect.
close
in interface Closeable
close
in interface AutoCloseable
close
in class Reader
© 1993–2017, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.