Stay organized with collections
Save and categorize content based on your preferences.
Readable
interface Readable
Known Indirect Subclasses
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.
|
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 .
|
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.
|
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 |
Attempts to read characters into the specified character buffer.
|
Public methods
read
abstract fun read(cb: CharBuffer!): Int
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 |
Return |
Int |
The number of char values added to the buffer, or -1 if this source of characters is at its end |
Exceptions |
java.io.IOException |
if an I/O error occurs |
java.lang.NullPointerException |
if cb is null |
java.nio.ReadOnlyBufferException |
if cb is a read only buffer |
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](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)\n\nReadable\n========\n\n```\ninterface Readable\n```\n\n|-------------------------|\n| [java.lang.Readable](#) |\n\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Known Direct Subclasses [CharBuffer](../nio/CharBuffer.html#), [Reader](../io/Reader.html#) |---------------------------------------|-----------------------------------------------| | [CharBuffer](../nio/CharBuffer.html#) | A char buffer. | | [Reader](../io/Reader.html#) | Abstract class for reading character streams. | |\n\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Known Indirect Subclasses [BufferedReader](../io/BufferedReader.html#), [CharArrayReader](../io/CharArrayReader.html#), [FileReader](../io/FileReader.html#), [FilterReader](../io/FilterReader.html#), [InputStreamReader](../io/InputStreamReader.html#), [LineNumberReader](../io/LineNumberReader.html#), [PipedReader](../io/PipedReader.html#), [PushbackReader](../io/PushbackReader.html#), [StringReader](../io/StringReader.html#) |----------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------| | [BufferedReader](../io/BufferedReader.html#) | Reads text from a character-input stream, buffering characters so as to provide for the efficient reading of characters, arrays, and lines. | | [CharArrayReader](../io/CharArrayReader.html#) | This class implements a character buffer that can be used as a character-input stream. | | [FileReader](../io/FileReader.html#) | Reads text from character files using a default buffer size. | | [FilterReader](../io/FilterReader.html#) | Abstract class for reading filtered character streams. | | [InputStreamReader](../io/InputStreamReader.html#) | An InputStreamReader is a bridge from byte streams to character streams: It reads bytes and decodes them into characters using a specified . | | [LineNumberReader](../io/LineNumberReader.html#) | A buffered character-input stream that keeps track of line numbers. | | [PipedReader](../io/PipedReader.html#) | Piped character-input streams. | | [PushbackReader](../io/PushbackReader.html#) | A character-stream reader that allows characters to be pushed back into the stream. | | [StringReader](../io/StringReader.html#) | A character stream whose source is a string. | |\n\nA `Readable` is a source of characters. Characters from a `Readable` are made available to callers of the read method via a [CharBuffer](../nio/CharBuffer.html#).\n\nSummary\n-------\n\n| Public methods ||\n|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|\n| abstract [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [read](#read(java.nio.CharBuffer))`(`cb:` `[CharBuffer](../nio/CharBuffer.html#)!`)` Attempts to read characters into the specified character buffer. |\n\nPublic methods\n--------------\n\n### read\n\nAdded in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) \n\n```\nabstract fun read(cb: CharBuffer!): Int\n```\n\nAttempts 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.\n\n| Parameters ||\n|------|----------------------------------------------------------------------------|\n| `cb` | [CharBuffer](../nio/CharBuffer.html#)!: the buffer to read characters into |\n\n| Return ||\n|----------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------|\n| [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | The number of `char` values added to the buffer, or -1 if this source of characters is at its end |\n\n| Exceptions ||\n|------------------------------------|-----------------------------|\n| `java.io.IOException` | if an I/O error occurs |\n| `java.lang.NullPointerException` | if cb is null |\n| `java.nio.ReadOnlyBufferException` | if cb is a read only buffer |"]]