java.io.InputStreamReader

The InputStreamReader class of java.io package, is a bridge from byte streams to character streams: It reads bytes and decodes them into characters using a specified charset. The charset that it uses may be specified by name or may be given explicitly, or the platform’s default charset may be accepted.
Each invocation of one of an InputStreamReader’s read() methods may cause one or more bytes to be read from the underlying byte-input stream. To enable the efficient conversion of bytes to characters, more bytes may be read ahead from the underlying stream than are necessary to satisfy the current read operation.

For efficiency and ease of use, the InputStreamReader as a general practice is wrapped with BufferedReader. For example:

BufferedReader in = new BufferedReader(new InputStreamReader(System.in));

InputStreamReader Class Syntax

public class InputStreamReader
extends Reader

InputStreamReader Class Compatibility Version

InputStreamReader Class is available since Java 1.1

Basic Usage of InputStreamReader

The InputStreamReader class as part of the java.io package is one of the classes of the java api that is widely used because it provides mechanism in reading a stream. This class offer methods to read file or console input, however since the methods available is hard to use, as a general practice it is recommended to wrap it to more user friendly BufferedReader.

InputStreamReader Method Usage Examples

The following are the detailed list of InputStreamReader methods and descriptions. We have also provided links to examples of each method on the list.

Modifier and Type Method and Description
void close()
Closes the stream and releases any system resources associated with it.
String getEncoding()
Returns the name of the character encoding being used by this stream.
int read()
Reads a single character.
int read(char[] cbuf, int offset, int length)
Reads characters into a portion of an array.
boolean ready()
Tells whether this stream is ready to be read.