Stay organized with collections
Save and categorize content based on your preferences.
Readable
public
interface
Readable
Known indirect subclasses
BufferedReader, CharArrayReader, CharBuffer, FileReader, FilterReader, InputStreamReader, LineNumberReader, PipedReader, PushbackReader, Reader, StringReader
| BufferedReader |
Reads text from a character-input stream, buffering characters so as to
provide for the efficient reading of characters, arrays, and lines.
|
| CharArrayReader |
This class implements a character buffer that can be used as a
character-input stream.
|
| CharBuffer |
A char buffer.
|
| FileReader |
Reads text from character files using a default buffer size.
|
| FilterReader |
Abstract class for reading filtered character streams.
|
| InputStreamReader |
An InputStreamReader is a bridge from byte streams to character streams: It
reads bytes and decodes them into characters using a specified charset.
|
| LineNumberReader |
A buffered character-input stream that keeps track of line numbers.
|
| PipedReader |
Piped character-input streams.
|
| PushbackReader |
A character-stream reader that allows characters to be pushed back into the
stream.
|
| Reader |
Abstract class for reading character streams.
|
| StringReader |
A character stream whose source is a string.
|
|
A Readable is a source of characters. Characters from
a Readable are made available to callers of the read
method via a CharBuffer.
Summary
Public methods |
|---|
abstract
int
|
read(CharBuffer cb)
Attempts to read characters into the specified character buffer.
|
Public methods
read
public abstract int read (CharBuffer cb)
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 |
CharBuffer: the buffer to read characters into |
| Returns |
|---|
int |
The number of char values added to the buffer,
or -1 if this source of characters is at its end |
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-02-10 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-02-10 UTC."],[],[],null,["# Readable\n\nAdded in [API level 1](/guide/topics/manifest/uses-sdk-element#ApiLevels) \nSummary: [Methods](#pubmethods) \n\nReadable\n========\n\n\n`\npublic\n\n\ninterface\nReadable\n`\n\n\n`\n\n\n`\n\n|--------------------|\n| java.lang.Readable |\n\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Known indirect subclasses [BufferedReader](/reference/java/io/BufferedReader), [CharArrayReader](/reference/java/io/CharArrayReader), [CharBuffer](/reference/java/nio/CharBuffer), [FileReader](/reference/java/io/FileReader), [FilterReader](/reference/java/io/FilterReader), [InputStreamReader](/reference/java/io/InputStreamReader), [LineNumberReader](/reference/java/io/LineNumberReader), [PipedReader](/reference/java/io/PipedReader), [PushbackReader](/reference/java/io/PushbackReader), [Reader](/reference/java/io/Reader), [StringReader](/reference/java/io/StringReader) |-----------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [BufferedReader](/reference/java/io/BufferedReader) | Reads text from a character-input stream, buffering characters so as to provide for the efficient reading of characters, arrays, and lines. | | [CharArrayReader](/reference/java/io/CharArrayReader) | This class implements a character buffer that can be used as a character-input stream. | | [CharBuffer](/reference/java/nio/CharBuffer) | A char buffer. | | [FileReader](/reference/java/io/FileReader) | Reads text from character files using a default buffer size. | | [FilterReader](/reference/java/io/FilterReader) | Abstract class for reading filtered character streams. | | [InputStreamReader](/reference/java/io/InputStreamReader) | An InputStreamReader is a bridge from byte streams to character streams: It reads bytes and decodes them into characters using a specified [charset](/reference/java/nio/charset/Charset). | | [LineNumberReader](/reference/java/io/LineNumberReader) | A buffered character-input stream that keeps track of line numbers. | | [PipedReader](/reference/java/io/PipedReader) | Piped character-input streams. | | [PushbackReader](/reference/java/io/PushbackReader) | A character-stream reader that allows characters to be pushed back into the stream. | | [Reader](/reference/java/io/Reader) | Abstract class for reading character streams. | | [StringReader](/reference/java/io/StringReader) | A character stream whose source is a string. | |\n\n\u003cbr /\u003e\n\n*** ** * ** ***\n\nA `Readable` is a source of characters. Characters from\na `Readable` are made available to callers of the read\nmethod via a [CharBuffer](/reference/java/nio/CharBuffer).\n\nSummary\n-------\n\n| ### Public methods ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` abstract int` | ` `[read](/reference/java/lang/Readable#read(java.nio.CharBuffer))`(`[CharBuffer](/reference/java/nio/CharBuffer)` cb) ` Attempts to read characters into the specified character buffer. |\n\nPublic methods\n--------------\n\n### read\n\nAdded in [API level 1](/guide/topics/manifest/uses-sdk-element#ApiLevels) \n\n```\npublic abstract int read (CharBuffer cb)\n```\n\nAttempts to read characters into the specified character buffer.\nThe buffer is used as a repository of characters as-is: the only\nchanges made are the results of a put operation. No flipping or\nrewinding of the buffer is performed.\n\n\u003cbr /\u003e\n\n| Parameters ||\n|------|---------------------------------------------------------|\n| `cb` | `CharBuffer`: the buffer to read characters into \u003cbr /\u003e |\n\n| Returns ||\n|-------|----------------------------------------------------------------------------------------------------------|\n| `int` | The number of `char` values added to the buffer, or -1 if this source of characters is at its end \u003cbr /\u003e |\n\n| Throws ||\n|------------------------------------------------------------------------|-----------------------------|\n| [IOException](/reference/java/io/IOException) | if an I/O error occurs |\n| [NullPointerException](/reference/java/lang/NullPointerException) | if cb is null |\n| [ReadOnlyBufferException](/reference/java/nio/ReadOnlyBufferException) | if cb is a read only buffer |"]]
