- All Known Implementing Classes:
BufferedReader
,CharArrayReader
,CharBuffer
,FileReader
,FilterReader
,InputStreamReader
,LineNumberReader
,PipedReader
,PushbackReader
,Reader
,StringReader
,URLReader
public interface Readable
AReadable
is a source of characters. Characters from aReadable
are made available to callers of the read method via aCharBuffer
.- Since:
- 1.5
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description int
read(CharBuffer cb)
Attempts to read characters into the specified character buffer.
Method Detail
read
int read(CharBuffer cb) throws IOException
Attempts to read characters into the specified character buffer. The buffer is used as a repository of characters as-is: the only changes made are the results of a put operation. No flipping or rewinding of the buffer is performed.- Parameters:
cb
- the buffer to read characters into- Returns:
- The number of
char
values added to the buffer, or -1 if this source of characters is at its end - Throws:
IOException
- if an I/O error occursNullPointerException
- if cb is nullReadOnlyBufferException
- if cb is a read only buffer