JavaTM 2 Platform
Standard Ed. 5.0

java.lang
Interface Readable

All Known Implementing Classes:
BufferedReader, CharArrayReader, CharBuffer, FileReader, FilterReader, InputStreamReader, LineNumberReader, PipedReader, PushbackReader, Reader, StringReader

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
 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:
@return 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 occurs
NullPointerException - if cb is null
ReadOnlyBufferException - if cb is a read only buffer

JavaTM 2 Platform
Standard Ed. 5.0

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright © 2004, 2010 Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.