java.lang.Object | ||
↳ | java.io.Reader | |
↳ | java.io.BufferedReader |
Known Direct Subclasses |
Wraps an existing Reader
and buffers the input. Expensive
interaction with the underlying reader is minimized, since most (smaller)
requests can be satisfied by accessing the buffer alone. The drawback is that
some extra space is required to hold the buffer and that copying takes place
when filling that buffer, but this is usually outweighed by the performance
benefits.
BufferedReader buf = new BufferedReader(new FileReader("file.java"));
[Expand]
Inherited Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.io.Reader
|
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Constructs a new
BufferedReader , providing in with a buffer
of 8192 characters. | |||||||||||
Constructs a new
BufferedReader , providing in with size characters
of buffer. |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Closes this reader.
| |||||||||||
Sets a mark position in this reader.
| |||||||||||
Indicates whether this reader supports the
mark() and
reset() methods. | |||||||||||
Reads a single character from this reader and returns it with the two
higher-order bytes set to 0.
| |||||||||||
Reads up to
length characters from this reader and stores them
at offset in the character array buffer . | |||||||||||
Returns the next line of text available from this reader.
| |||||||||||
Indicates whether this reader is ready to be read without blocking.
| |||||||||||
Resets this reader's position to the last
mark() location. | |||||||||||
Skips at most
charCount chars in this stream. |
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.io.Reader
| |||||||||||
From class
java.lang.Object
| |||||||||||
From interface
java.io.Closeable
| |||||||||||
From interface
java.lang.AutoCloseable
| |||||||||||
From interface
java.lang.Readable
|
Constructs a new BufferedReader
, providing in
with a buffer
of 8192 characters.
in | the Reader the buffer reads from.
|
---|
Constructs a new BufferedReader
, providing in
with size
characters
of buffer.
in | the InputStream the buffer reads from. |
---|---|
size | the size of buffer in characters. |
IllegalArgumentException | if size <= 0 .
|
---|
Closes this reader. This implementation closes the buffered source reader and releases the buffer. Nothing is done if this reader has already been closed.
IOException | if an error occurs while closing this reader. |
---|
Sets a mark position in this reader. The parameter markLimit
indicates how many characters can be read before the mark is invalidated.
Calling reset()
will reposition the reader back to the marked
position if markLimit
has not been surpassed.
markLimit | the number of characters that can be read before the mark is invalidated. |
---|
IllegalArgumentException | if markLimit < 0 . |
---|---|
IOException | if an error occurs while setting a mark in this reader. |
Reads a single character from this reader and returns it with the two higher-order bytes set to 0. If possible, BufferedReader returns a character from the buffer. If there are no characters available in the buffer, it fills the buffer and then returns a character. It returns -1 if there are no more characters in the source reader.
IOException | if this reader is closed or some other I/O error occurs. |
---|
Reads up to length
characters from this reader and stores them
at offset
in the character array buffer
. Returns the
number of characters actually read or -1 if the end of the source reader
has been reached. If all the buffered characters have been used, a mark
has not been set and the requested number of characters is larger than
this readers buffer size, BufferedReader bypasses the buffer and simply
places the results directly into buffer
.
IndexOutOfBoundsException | if offset < 0 || length < 0 || offset + length > buffer.length . |
---|---|
IOException | if this reader is closed or some other I/O error occurs. |
Returns the next line of text available from this reader. A line is
represented by zero or more characters followed by '\n'
,
'\r'
, "\r\n"
or the end of the reader. The string does
not include the newline sequence.
null
if no characters were
read before the end of the reader has been reached.IOException | if this reader is closed or some other I/O error occurs. |
---|
Indicates whether this reader is ready to be read without blocking.
true
if this reader will not block when read
is
called, false
if unknown or blocking will occur.IOException | if this reader is closed or some other I/O error occurs. |
---|
Resets this reader's position to the last mark()
location.
Invocations of read()
and skip()
will occur from this new
location.
IOException | if this reader is closed or no mark has been set. |
---|
Skips at most charCount
chars in this stream. Subsequent calls to
read
will not return these chars unless reset
is
used.
Skipping characters may invalidate a mark if markLimit
is surpassed.
IllegalArgumentException | if charCount < 0 . |
---|---|
IOException | if this reader is closed or some other I/O error occurs. |