Класс Reader

protected Object lock

protected Reader()

protected Reader(Object lock)

Параметры:

lock — объект, на котором выполняется синхронизация.

public static Reader nullReader()

Возвращает:

Reader, который не читает символы

Начиная с:

11

public static Reader of(CharSequence cs)

Параметры:

cs — CharSequence, предоставляющая символьный поток.

Возвращает:

Reader, который читает символы из cs

Выбрасывает:

NullPointerException — если cs имеет значение null

Начиная с:

24

public int read(CharBuffer target) throws IOException

Определён в:

read в интерфейсе Readable

Параметры:

target — буфер для чтения символов

Возвращает:

Количество символов, добавленных в буфер (возможно, ноль), или -1, если источник символов исчерпан

Выбрасывает:

IOException — при возникновении ошибки ввода-вывода

NullPointerException — если target равен null

ReadOnlyBufferException — если target — буфер только для чтения, даже если его длина равна нулю

Начиная с:

1.5

public int read() throws IOException

Возвращает:

Считанный символ в виде целого числа в диапазоне от 0 до 65535 (0x00-0xffff) или -1, если достигнут конец потока

Выбрасывает:

IOException — при возникновении ошибки ввода-вывода

public int read(char[] cbuf) throws IOException

Параметры:

cbuf — буфер назначения

Возвращает:

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

Выбрасывает:

IOException — при возникновении ошибки ввода-вывода

public abstract int read(char[] cbuf, int off, int len) throws IOException

Параметры:

cbuf — буфер назначения

off — смещение, с которого начинается сохранение символов

len — максимальное количество считываемых символов

Возвращает:

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

Выбрасывает:

IndexOutOfBoundsException — если off отрицателен, или len отрицателен, или len больше cbuf.length - off

IOException — при возникновении ошибки ввода-вывода

public List<String> readAllLines() throws IOException

Примечание к API:

Этот метод предназначен для простых случаев, когда уместно и удобно считывать все входные данные в список строк. Он не подходит для чтения данных из неизвестного источника, поскольку это может привести к выделению произвольного объёма памяти.

Возвращает:

оставшиеся символы в виде строк текста, сохранённых в неизменяемом List из String в порядке их чтения

Выбрасывает:

IOException — при возникновении ошибки ввода-вывода

OutOfMemoryError — если количество оставшихся символов превышает ограничение реализации для String.

Начиная с:

25

См. также:

• String.lines()
• readAllAsString()
• Files.readAllLines(Path, Charset)

public String readAllAsString() throws IOException

Примечание к API:

Этот метод предназначен для простых случаев, когда уместно и удобно считывать все входные данные в String. Он не подходит для чтения данных из неизвестного источника, поскольку это может привести к выделению произвольного объёма памяти.

Возвращает:

String, содержащую все оставшиеся символы

Выбрасывает:

IOException — при возникновении ошибки ввода-вывода

OutOfMemoryError — если количество оставшихся символов превышает ограничение реализации для String.

Начиная с:

25

См. также:

• readAllLines()
• Files.readString(Path)

public long skip(long n) throws IOException

Параметры:

n — количество символов, которые требуется пропустить

Возвращает:

Фактическое количество пропущенных символов

Выбрасывает:

IllegalArgumentException — если n отрицателен.

IOException — при возникновении ошибки ввода-вывода

public boolean ready() throws IOException

Возвращает:

True, если гарантируется, что следующий вызов read() не будет блокироваться в ожидании входных данных; в противном случае false. Обратите внимание: возвращаемое значение false не гарантирует, что следующий вызов read будет блокироваться.

Выбрасывает:

IOException — при возникновении ошибки ввода-вывода

public boolean markSupported()

Возвращает:

true тогда и только тогда, когда этот поток поддерживает операцию mark.

public void mark(int readAheadLimit) throws IOException

Параметры:

readAheadLimit — ограничение на количество символов, которые можно прочитать с сохранением метки. После чтения этого количества символов попытка сбросить поток может завершиться неудачей.

Выбрасывает:

IOException — если поток не поддерживает mark() или произошла другая ошибка ввода-вывода

public void reset() throws IOException

Выбрасывает:

IOException — если метка в потоке не установлена или стала недействительной, если поток не поддерживает reset() либо произошла другая ошибка ввода-вывода

public abstract void close() throws IOException

Определён в:

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

Определён в:

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

Выбрасывает:

IOException — при возникновении ошибки ввода-вывода

public long transferTo(Writer out) throws IOException

Параметры:

out — объект записи, не равный null

Возвращает:

количество переданных символов

Выбрасывает:

IOException — при возникновении ошибки ввода-вывода во время чтения или записи

NullPointerException — если out имеет значение null

Начиная с:

10