java.io

Класс PushbackInputStream

java.lang. Объект

java.io. InputStream

java.io. FilterInputStream

java.io. PushbackInputStream

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

Closeable, AutoCloseable

public class PushbackInputStream
extends FilterInputStream

A PushbackInputStream добавляет функциональность к другому входному потоку, а именно, возможность "пододвинуть обратно" или "непрочитанный" один байт. Это полезно в ситуациях, где удобно для фрагмента кода считать неопределенное число байтов данных, которые разграничиваются определенным значением байта; после чтения завершающегося байта фрагмент кода может "непрочитанный" это, так, чтобы следующая операция чтения на входном потоке перечитала байт, который был пододвинут обратно. Например, байты, представляющие символы, составляющие идентификатор, могли бы быть завершены байтом, представляющим символ оператора; метод, задание которого должно считать только идентификатор, может читать, пока это не видит оператор, и затем продвиньте оператор назад быть перечитанным.

С тех пор:

JDK1.0

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

Поля

Модификатор и Тип	Поле и Описание
protected byte[]	buf Буфер pushback.
protected int	на месте продажи Позиция в пределах pushback буферизует, из которого будет считан следующий байт.

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

в

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

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

Конструктор и Описание
PushbackInputStream(InputStream in) Создает a PushbackInputStream и сохраняет его параметр, входной поток in, для более позднего использования.
PushbackInputStream(InputStream in, int size) Создает a PushbackInputStream с pushback буфером указанного size, и сохраняет его параметр, входной поток in, для более позднего использования.

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

Методы

Модификатор и Тип	Метод и Описание
int	available() Возвращает оценку числа байтов, которые могут быть считаны (или перескочиться) от этого входного потока, не блокируя следующим вызовом метода для этого входного потока.
void	close() Завершения этот входной поток и выпуски любые системные ресурсы связались с потоком.
void	mark(int readlimit) Отмечает текущую позицию в этом входном потоке.
boolean	markSupported() Тесты, если этот входной поток поддерживает mark и reset методы, которые это не делает.
int	read() Читает следующий байт данных от этого входного потока.
int	read(byte[] b, int off, int len) Чтения до len байты данных от этого входного потока в массив байтов.
void	reset() Репозиции этот поток к позиции в это время mark метод был последним, обращался к этому входному потоку.
long	skip(long n) Перескакивает и отбрасывает n байты данных от этого входного потока.
void	unread(byte[] b) Пододвигает массив обратно байтов, копируя это в переднюю сторону буфера pushback.
void	unread(byte[] b, int off, int len) Пододвигает часть обратно массива байтов, копируя это в переднюю сторону буфера pushback.
void	unread(int b) Пододвигает байт обратно, копируя это в переднюю сторону буфера pushback.

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

читать

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

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

Полевая Деталь

buf

protected byte[] buf

Буфер pushback.

С тех пор:

JDK1.1

на месте продажи

protected int pos

Позиция в пределах pushback буферизует, из которого будет считан следующий байт. Когда буфер пуст, pos равно buf.length; когда буфер полон, pos равно нулю.

С тех пор:

JDK1.1

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

PushbackInputStream

public PushbackInputStream(InputStream in,
                   int size)

Создает a PushbackInputStream с pushback буфером указанного size, и сохраняет его параметр, входной поток in, для более позднего использования. Первоначально, нет никакого назад продвинутого байта (поле pushBack инициализируется к -1).

Параметры:

in - входной поток, из которого будут считаны байты.

size - размер буфера pushback.

Броски:

IllegalArgumentException - если размер <= 0

С тех пор:

JDK1.1

PushbackInputStream

public PushbackInputStream(InputStream in)

Создает a PushbackInputStream и сохраняет его параметр, входной поток in, для более позднего использования. Первоначально, нет никакого назад продвинутого байта (поле pushBack инициализируется к -1).

Параметры:

in - входной поток, из которого будут считаны байты.

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

читать

public int read()
         throws IOException

Читает следующий байт данных от этого входного потока. Байт значения возвращается как int в диапазоне 0 к 255. Если никакой байт не доступен, потому что конец потока был достигнут, значение -1 возвращается. Этот метод блоки до входных данных доступен, конец потока обнаруживается, или исключение выдается.

Этот метод возвращает последний раз назад продвинутый байт, если есть один, и иначе вызывает read метод его базового входного потока и возвратов безотносительно значения тот метод возвраты.

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

read в классе FilterInputStream

Возвраты:

следующий байт данных, или -1 если конец потока был достигнут.

Броски:

IOException - если этот входной поток был закрыт, вызывая close() метод, или ошибка ввода-вывода происходит.

См. Также:

InputStream.read()

читать

public int read(byte[] b,
       int off,
       int len)
         throws IOException

Чтения до len байты данных от этого входного потока в массив байтов. Этот метод первые чтения любые назад продвинутые байты; после этого, если меньше чем len байты были считаны тогда, это читает из базового входного потока. Если len не нуль, блоки метода, пока по крайней мере 1 байт ввода не доступен; иначе, никакие байты не читаются и 0 возвращается.

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

read в классе FilterInputStream

Параметры:

b - буфер, в который читаются данные.

off - запуск смещается в целевом массиве b

len - максимальное количество байтов читало.

Возвраты:

общее количество чтения байтов в буфер, или -1 если нет больше данных, потому что конец потока был достигнут.

Броски:

NullPointerException - Если b null.

IndexOutOfBoundsException - Если off отрицательно, len отрицательно, или len больше чем b.length - off

IOException - если этот входной поток был закрыт, вызывая close() метод, или ошибка ввода-вывода происходит.

См. Также:

InputStream.read(byte[], int, int)

непрочитанный

public void unread(int b)
            throws IOException

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

Параметры:

b - int оцените, чей байт младшего разряда должен быть пододвинут обратно.

Броски:

IOException - Если есть недостаточно комнаты в буфере pushback для байта, или этот входной поток был закрыт, вызывая close() метод.

непрочитанный

public void unread(byte[] b,
          int off,
          int len)
            throws IOException

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

Параметры:

b - байтовый массив, чтобы пододвинуть обратно.

off - смещение запуска данных.

len - число байтов, чтобы пододвинуть обратно.

Броски:

IOException - Если есть недостаточно комнаты в буфере pushback для конкретного количества байтов, или этот входной поток был закрыт, вызывая close() метод.

С тех пор:

JDK1.1

непрочитанный

public void unread(byte[] b)
            throws IOException

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

Параметры:

b - байтовый массив, чтобы пододвинуть обратно

Броски:

IOException - Если есть недостаточно комнаты в буфере pushback для конкретного количества байтов, или этот входной поток был закрыт, вызывая close() метод.

С тех пор:

JDK1.1

доступный

public int available()
              throws IOException

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

Метод возвращает сумму числа байтов, которые были пододвинуты обратно и значение, возвращенное available.

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

available в классе FilterInputStream

Возвраты:

число байтов, которые могут быть считаны (или перескочиться) от входного потока без блокирования.

Броски:

IOException - если этот входной поток был закрыт, вызывая close() метод, или ошибка ввода-вывода происходит.

См. Также:

FilterInputStream.in, InputStream.available()

пропустить

public long skip(long n)
          throws IOException

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

skip метод PushbackInputStream сначала перескакивает через байты в буфере pushback, если любой. Это тогда вызывает skip метод базового входного потока, если больше байтов должно быть пропущено. Фактическое число пропущенных байтов возвращается.

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

skip в классе FilterInputStream

Параметры:

n - число байтов, которые будут пропущены.

Возвраты:

фактическое число байтов пропускается.

Броски:

IOException - если поток не поддерживает, ищут, или поток был закрыт, вызывая close() метод, или ошибка ввода-вывода происходит.

С тех пор:

1.2

См. Также:

FilterInputStream.in, InputStream.skip(long n)

markSupported

public boolean markSupported()

Тесты, если этот входной поток поддерживает mark и reset методы, которые это не делает.

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

markSupported в классе FilterInputStream

Возвраты:

false, так как этот класс не поддерживает mark и reset методы.

См. Также:

InputStream.mark(int), InputStream.reset()

метка

public void mark(int readlimit)

Отмечает текущую позицию в этом входном потоке.

mark метод PushbackInputStream ничего не делает.

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

mark в классе FilterInputStream

Параметры:

readlimit - максимальный предел байтов, которые могут быть считаны перед позицией метки, становится недопустимым.

См. Также:

InputStream.reset()

сброс

public void reset()
           throws IOException

Репозиции этот поток к позиции в это время mark метод был последним, обращался к этому входному потоку.

Метод reset для класса PushbackInputStream не делает ничего кроме броска IOException.

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

reset в классе FilterInputStream

Броски:

IOException - если этот метод вызывается.

См. Также:

InputStream.mark(int), IOException

близко

public void close()
           throws IOException

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

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

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

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

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

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

close в классе FilterInputStream

Броски:

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

См. Также:

FilterInputStream.in