Класс PushbackReader

public class PushbackReader
extends FilterReader

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

PushbackReader

public PushbackReader(Reader in,
                      int size)

Создаёт новый pushback ридер с буфером для возврата заданного размера.

Параметры:

in - Ридер, из которого будут считываться символы

size - Размер буфера возврата

Исключения:

IllegalArgumentException - если size <= 0

PushbackReader

public PushbackReader(Reader in)

Создаёт новый pushback ридер с буфером для возврата одного символа.

Параметры:

in - Ридер, из которого будут считываться символы

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

read

public int read()
         throws IOException

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

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

read в классе FilterReader

Возвращает:

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

Исключения:

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

read

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

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

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

read в классе FilterReader

Параметры:

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

off - Смещение для начала записи символов

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

Возвращает:

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

Исключения:

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

unread

public void unread(int c)
            throws IOException

Возвращает один символ, копируя его в начало буфера возврата. После выполнения этого метода, следующий символ для чтения будет иметь значение (char)c.

Параметры:

c - Целое значение, представляющее символ для возврата

Исключения:

IOException - Если буфер возврата полон или произошла другая ошибка ввода-вывода

unread

public void unread(char[] cbuf,
                   int off,
                   int len)
            throws IOException

Возвращает часть массива символов, копируя её в начало буфера возврата. После выполнения этого метода, следующий символ для чтения будет иметь значение cbuf[off], следующий за ним - cbuf[off+1], и так далее.

Параметры:

cbuf - Массив символов

off - Смещение первого символа для возврата

len - Количество символов для возврата

Исключения:

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

unread

public void unread(char[] cbuf)
            throws IOException

Возвращает массив символов, копируя его в начало буфера возврата. После выполнения этого метода, следующий символ для чтения будет иметь значение cbuf[0], следующий за ним - cbuf[1], и так далее.

Параметры:

cbuf - Массив символов для возврата

Исключения:

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

ready

public boolean ready()
              throws IOException

Указывает, готов ли этот поток к чтению.

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

ready в классе FilterReader

Возвращает:

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

Исключения:

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

mark

public void mark(int readAheadLimit)
          throws IOException

Помечает текущую позицию в потоке. Метод mark для класса PushbackReader всегда выбрасывает исключение.

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

mark в классе FilterReader

Параметры:

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

Исключения:

IOException - Всегда, так как mark не поддерживается

reset

public void reset()
           throws IOException

Сбрасывает поток. Метод reset метода PushbackReader всегда выбрасывает исключение.

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

reset в классе FilterReader

Исключения:

IOException - Всегда, так как reset не поддерживается

markSupported

public boolean markSupported()

Указывает, поддерживает ли этот поток операцию mark(), которой он не обладает.

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

markSupported в классе FilterReader

Возвращает:

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

close

public void close()
           throws IOException

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

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

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

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

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

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

close в классе FilterReader

Исключения:

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

skip

public long skip(long n)
          throws IOException

Пропускает символы. Этот метод будет заблокирован, пока некоторые символы не станут доступными, не произойдёт ошибка ввода-вывода или не будет достигнут конец потока.

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

skip в классе FilterReader

Параметры:

n - Количество символов для пропуска

Возвращает:

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

Исключения:

IllegalArgumentException - Если n отрицательно.

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