compact1, compact2, compact3

java.io

Класс BufferedInputStream

java.lang. Объект

java.io. InputStream

java.io. FilterInputStream

java.io. BufferedInputStream

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

Closeable, AutoCloseable

public class BufferedInputStream
extends FilterInputStream

A BufferedInputStream добавляет функциональность к другому входному потоку а именно, возможность буферизовать ввод и поддерживать mark и reset методы. Когда BufferedInputStream создается, внутренний буферный массив создается. Поскольку байты от потока читаются или пропускаются, внутренний буфер снова наполняется по мере необходимости от содержавшего входного потока, много байтов за один раз. mark работа помнит точку во входном потоке и reset работа вызывает все чтение байтов начиная с нового mark работа, которая будет перечитана перед новыми байтами, берется от содержавшего входного потока.

С тех пор:

JDK1.0

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

Поля

Модификатор и Тип	Поле и Описание
protected byte[]	buf Внутренний буферный массив, где данные хранятся.
protected int	количество Индексирование одного большего чем индексирование последнего допустимого байта в буфере.
protected int	marklimit Максимальное чтение, вперед позволенное после звонка mark метод перед последующими звонками reset сбой метода.
protected int	markpos Значение pos поле в это время последнее mark метод вызвали.
protected int	на месте продажи Текущая позиция в буфере.

Поля, наследованные от class java.io. FilterInputStream

в

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

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

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

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

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

Методы, наследованные от class java.io. FilterInputStream

читать

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

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

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

buf

protected volatile byte[] buf

Внутренний буферный массив, где данные хранятся. Когда необходимо это может быть заменено другим массивом различного размера.

количество

protected int count

Индексирование одного большего чем индексирование последнего допустимого байта в буфере. Это значение всегда находится в диапазоне 0 через buf.length; элементы buf[0] через buf[count-1] содержите буферизованные входные данные, полученные из базового входного потока.

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

protected int pos

Текущая позиция в буфере. Это - индексирование следующего символа, который будет считан из buf массив.

Это значение всегда находится в диапазоне 0 через count. Если это - меньше чем count, тогда buf[pos] следующий байт, который будет предоставлен как входной; если это равно count, тогда следующее read или skip работа потребует, чтобы больше байтов было считано из содержавшего входного потока.

См. Также:

buf

markpos

protected int markpos

Значение pos поле в это время последнее mark метод вызвали.

Это значение всегда находится в диапазоне -1 через pos. Если нет никакой отмеченной позиции во входном потоке, это поле -1. Если есть отмеченная позиция во входном потоке, то buf[markpos] первый байт, который будет предоставлен как входной после a reset работа. Если markpos не -1, тогда все байты от позиций buf[markpos] через buf[pos-1] должен остаться в буферном массиве (хотя они могут быть перемещены в другое место в буферном массиве с подходящими корректировками значений count, pos, и markpos); они не могут быть отброшены только после того как различие между pos и markpos превышает marklimit.

См. Также:

mark(int), pos

marklimit

protected int marklimit

Максимальное чтение, вперед позволенное после звонка mark метод перед последующими звонками reset сбой метода. Всякий раз, когда различие между pos и markpos превышает marklimit, тогда метка может быть отброшена, устанавливая markpos к -1.

См. Также:

mark(int), reset()

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

BufferedInputStream

public BufferedInputStream(InputStream in)

Создает a BufferedInputStream и сохраняет его параметр, входной поток in, для более позднего использования. Внутренний буферный массив создается и сохранен в buf.

Параметры:

in - базовый входной поток.

BufferedInputStream

public BufferedInputStream(InputStream in,
                           int size)

Создает a BufferedInputStream с указанным размером буфера, и сохраняет его параметр, входной поток in, для более позднего использования. Внутренний буферный массив длины size создается и сохранен в buf.

Параметры:

in - базовый входной поток.

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

Броски:

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

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

читать

public int read()
         throws IOException

См. общий контракт read метод InputStream.

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

read в class FilterInputStream

Возвраты:

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

Броски:

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

См. Также:

FilterInputStream.in

читать

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

Байты чтений от этого введенного байтом потока в указанный байтовый массив, запускающийся при данном смещении.

Этот метод реализует общий контракт соответствия read метод InputStream class. Как дополнительное удобство, это пытается считать так много байтов насколько возможно, неоднократно вызывая read метод базового потока. Это выполнило итерации read продолжается, пока одно из следующих условий не становится истиной:

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

Если первое read по базовым потоковым возвратам -1 указать на конец файла тогда этот метод возвраты -1. Иначе этот метод возвращает число байтов фактически чтение.

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

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

read в class FilterInputStream

Параметры:

b - целевой буфер.

off - смещение, при котором можно начать хранить байты.

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

Возвраты:

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

Броски:

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

См. Также:

FilterInputStream.in

пропустить

public long skip(long n)
          throws IOException

См. общий контракт skip метод InputStream.

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

skip в class FilterInputStream

Параметры:

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

Возвраты:

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

Броски:

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

доступный

public int available()
              throws IOException

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

Этот метод возвращает сумму числа байтов, остающихся быть считанными в буфере (count - pos) и результат вызова in.available ().

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

available в class FilterInputStream

Возвраты:

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

Броски:

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

метка

public void mark(int readlimit)

См. общий контракт mark метод InputStream.

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

mark в class FilterInputStream

Параметры:

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

См. Также:

reset()

сброс

public void reset()
           throws IOException

См. общий контракт reset метод InputStream.

Если markpos -1 (никакая метка не была установлена, или метка была лишена законной силы), IOException бросается. Иначе, pos устанавливается равный markpos.

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

reset в class FilterInputStream

Броски:

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

См. Также:

mark(int)

markSupported

public boolean markSupported()

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

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

markSupported в class FilterInputStream

Возвраты:

a boolean указание, поддерживает ли этот потоковый тип mark и reset методы.

См. Также:

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

близко

public void close()
           throws IOException

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

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

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

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

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

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

close в class FilterInputStream

Броски:

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

См. Также:

FilterInputStream.in