- All Known Implementing Classes:
 BufferedReader,CharArrayReader,CharBuffer,FileReader,FilterReader,InputStreamReader,LineNumberReader,PipedReader,PushbackReader,Reader,StringReader,URLReader
public interface Readable
A 
Readable is a source of characters. Characters from
 a Readable are made available to callers of the read
 method via a CharBuffer.- Since:
 - 1.5
 
- 
Method Summary
Modifier and Type Method Description intread(CharBuffer cb)Attempts to read characters into the specified character buffer. 
- 
Method Details
- 
read
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 
charvalues 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
 
 -