Класс InputStreamReader

public class InputStreamReader
extends Reader

InputStreamReader — это мост от потоков байтов к потокам символов: он считывает байты и декодирует их в символы, используя указанный charset. Кодировка символов, которую он использует, может быть указана по имени, явно задана или принята по умолчанию для платформы.

Каждый вызов одного из методов read() класса InputStreamReader может вызвать чтение одного или нескольких байтов из базового потока ввода байтов. Для эффективного преобразования байтов в символы может быть прочитано больше байтов из базового потока, чем необходимо для текущей операции чтения.

Для максимальной эффективности рекомендуется обернуть InputStreamReader в BufferedReader. Например:

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

Подробное описание конструкторов

InputStreamReader

public InputStreamReader(InputStream in)

Создаёт InputStreamReader, использующий кодировку по умолчанию.

Параметры:

in - Поток ввода

InputStreamReader

public InputStreamReader(InputStream in,
                         String charsetName)
                  throws UnsupportedEncodingException

Создаёт InputStreamReader, использующий кодировку по имени.

Параметры:

in - Поток ввода

charsetName - Имя поддерживаемой charset

Исключения:

UnsupportedEncodingException - Если кодировка по имени не поддерживается

InputStreamReader

public InputStreamReader(InputStream in,
                         Charset cs)

Создаёт InputStreamReader, использующий указанную кодировку.

Параметры:

in - Поток ввода

cs - Кодировка

С:

1.4

InputStreamReader

public InputStreamReader(InputStream in,
                         CharsetDecoder dec)

Создаёт InputStreamReader, использующий указанный декодер кодировки.

Параметры:

in - Поток ввода

dec - Декодер кодировки

С:

1.4

Подробное описание методов

getEncoding

public String getEncoding()

Возвращает:

Историческое имя этой кодировки или null если поток закрыт

См. также:

Charset

read

public int read()
         throws IOException

Считывает один символ.

Переопределяет:

read в классе Reader

Возвращает:

Прочитанный символ или -1, если достигнут конец потока

Исключения:

IOException - Если произошла ошибка ввода/вывода

read

public int read(char[] cbuf,
                int offset,
                int length)
         throws IOException

Считывает символы в часть массива.

Определено в:

read в классе Reader

Параметры:

cbuf - Буфер назначения

offset - Смещение, с которого начинать хранение символов

length - Максимальное количество символов для чтения

Возвращает:

Количество прочитанных символов или -1, если достигнут конец потока

Исключения:

IOException - Если произошла ошибка ввода/вывода

ready

public boolean ready()
              throws IOException

Определяет, готов ли этот поток к чтению. InputStreamReader готов, если его буфер ввода не пуст или если байты доступны для чтения из базового потока байтов.

Переопределяет:

ready в классе Reader

Возвращает:

True, если следующее чтение гарантированно не заблокируется в ожидании ввода, false в противном случае. Обратите внимание, что возвращение false не гарантирует, что следующее чтение заблокируется.

Исключения:

IOException - Если произошла ошибка ввода/вывода

close

public void close()
           throws IOException

Описание скопировано из класса: Reader

Закрывает поток и освобождает связанные с ним системные ресурсы. После закрытия потока дальнейшие вызовы read(), ready(), mark(), reset() или skip() будут генерировать исключение IOException. Закрытие уже закрытого потока не оказывает никакого влияния.

Определено в:

close в интерфейсе Closeable

Определено в:

close в интерфейсе AutoCloseable

Определено в:

close в классе Reader

Исключения:

IOException - Если произошла ошибка ввода/вывода