java.io

Класс InputStreamReader

java.lang. Объект

java.io. Читатель

java.io. InputStreamReader

Все Реализованные Интерфейсы:

Closeable, AutoCloseable, Читаемый

Прямые Известные Подклассы:

FileReader

public class InputStreamReader
extends Reader

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

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

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

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

С тех пор:

JDK1.1

См. Также:

BufferedReader, InputStream, Charset

Полевая Сводка

Поля java.io унаследованный от класса. Читатель

блокировка

Сводка конструктора

Конструкторы

Конструктор и Описание
InputStreamReader(InputStream in) Создает InputStreamReader, который использует набор символов по умолчанию.
InputStreamReader(InputStream in, Charset cs) Создает InputStreamReader, который использует данный набор символов.
InputStreamReader(InputStream in, CharsetDecoder dec) Создает InputStreamReader, который использует данный декодер набора символов.
InputStreamReader(InputStream in, String charsetName) Создает InputStreamReader, который использует именованный набор символов.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	close() Закрывает поток и выпускает любые системные ресурсы, связанные с этим.
Строка	getEncoding() Возвращает имя кодировки символов, используемой этим потоком.
int	read() Читает единственный символ.
int	read(char[] cbuf, int offset, int length) Символы чтений в часть массива.
boolean	ready() Говорит, готов ли этот поток быть считанным.

Методы java.io унаследованный от класса. Читатель

mark, markSupported, read, read, reset, skip

Методы java.lang унаследованный от класса. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

InputStreamReader

public InputStreamReader(InputStream in)

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

Параметры:

in - InputStream

InputStreamReader

public InputStreamReader(InputStream in,
                 String charsetName)
                  throws UnsupportedEncodingException

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

Параметры:

in - InputStream

charsetName - Имя поддерживаемого набор символов

Броски:

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

InputStreamReader

public InputStreamReader(InputStream in,
                 Charset cs)

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

Параметры:

in - InputStream

cs - Набор символов

С тех пор:

1.4

InputStreamReader

public InputStreamReader(InputStream in,
                 CharsetDecoder dec)

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

Параметры:

in - InputStream

dec - Декодер набора символов

С тех пор:

1.4

Деталь метода

getEncoding

public String getEncoding()

Возвращает имя кодировки символов, используемой этим потоком.

Если у кодирования есть историческое имя тогда, что имя возвращается; иначе каноническое имя кодирования возвращается.

Если этот экземпляр создавался с InputStreamReader(InputStream, String) конструктор тогда возвращенное имя, будучи уникальным для кодирования, может отличаться от имени, которое передают конструктору. Этот метод возвратится null если поток был закрыт.

Возвраты:

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

См. Также:

Charset

читать

public int read()
         throws IOException

Читает единственный символ.

Переопределения:

read в классе Reader

Возвраты:

Символьное чтение, или-1, если конец потока был достигнут

Броски:

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

читать

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

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

Определенный:

read в классе Reader

Параметры:

cbuf - Целевой буфер

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

length - Максимальное количество символов, чтобы читать

Возвраты:

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

Броски:

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

готовый

public boolean ready()
              throws IOException

Говорит, готов ли этот поток быть считанным. InputStreamReader готов, если его входной буфер не пуст, или если байты доступны, чтобы быть считанными из базового потока байтов.

Переопределения:

ready в классе Reader

Возвраты:

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

Броски:

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

близко

public void close()
           throws IOException

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

Закрывает поток и выпускает любые системные ресурсы, связанные с этим. Как только поток был закрыт, далее считайте (), готовый (), метка (), сбросьте (), или пропуск (), вызовы бросят IOException. Закрытие ранее закрытого потока не имеет никакого эффекта.

Определенный:

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

Определенный:

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

Определенный:

close в классе Reader

Броски:

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