PushbackInputStream (Платформа Java SE 8 b92)

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 буферизует, из которого будет считан следующий байт.

Поля, наследованные от class 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.

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

Методы, наследованные от class 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 в class FilterInputStream
    
    Возвраты:
    
    следующий байт данных, или -1 если конец потока был достигнут.
    
    Броски:
    
    IOException - если этот входной поток был закрыт, вызывая close() метод, или ошибка ввода-вывода происходит.
    
    См. Также:
    
    InputStream.read()
  - читать
```
public int read(byte[] b,
                int off,
                int len)
         throws IOException
```
    Чтения до len байты данных от этого входного потока в массив байтов. Этот метод первые чтения любые назад продвинутые байты; после этого, если меньше чем len байты были считаны тогда, это читает из базового входного потока. Если len не нуль, блоки метода, пока по крайней мере 1 байт ввода не доступен; иначе, никакие байты не читаются и 0 возвращается.
    
    Переопределения:
    
    read в class 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 в class FilterInputStream
    
    Возвраты:
    
    число байтов, которые могут быть считаны (или перескочиться) от входного потока без блокирования.
    
    Броски:
    
    IOException - если этот входной поток был закрыт, вызывая close() метод, или ошибка ввода-вывода происходит.
    
    См. Также:
    
    FilterInputStream.in, InputStream.available()
  - пропустить
```
public long skip(long n)
          throws IOException
```
    Перескакивает и отбрасывает n байты данных от этого входного потока. skip метод, для множества причин, может закончить тем, что перескочил через некоторое меньшее число байтов, возможно обнулить. Если n отрицательно, никакие байты не пропускаются.
    skip метод PushbackInputStream сначала перескакивает через байты в буфере pushback, если любой. Это тогда вызывает skip метод базового входного потока, если больше байтов должно быть пропущено. Фактическое число пропущенных байтов возвращается.
    
    Переопределения:
    
    skip в class FilterInputStream
    
    Параметры:
    
    n - число байтов, которые будут пропущены.
    
    Возвраты:
    
    фактическое число байтов пропускается.
    
    Броски:
    
    IOException - если поток не поддерживает, ищут, или поток был закрыт, вызывая close() метод, или ошибка ввода-вывода происходит.
    
    С тех пор:
    
    1.2
    
    См. Также:
    
    FilterInputStream.in, InputStream.skip(long n)
  - markSupported
```
public boolean markSupported()
```
    Тесты, если этот входной поток поддерживает mark и reset методы, которые это не делает.
    
    Переопределения:
    
    markSupported в class FilterInputStream
    
    Возвраты:
    
    false, так как этот class не поддерживает mark и reset методы.
    
    См. Также:
    
    InputStream.mark(int), InputStream.reset()
  - метка
```
public void mark(int readlimit)
```
    Отмечает текущую позицию в этом входном потоке.
    mark метод PushbackInputStream ничего не делает.
    
    Переопределения:
    
    mark в class FilterInputStream
    
    Параметры:
    
    readlimit - максимальный предел байтов, которые могут быть считаны перед позицией метки, становится недопустимым.
    
    См. Также:
    
    InputStream.reset()
  - сброс
```
public void reset()
           throws IOException
```
    Репозиции этот поток к позиции в это время mark метод был последним, обращался к этому входному потоку.
    Метод reset для class PushbackInputStream не делает ничего кроме броска IOException.
    
    Переопределения:
    
    reset в class FilterInputStream
    
    Броски:
    
    IOException - если этот метод вызывается.
    
    См. Также:
    
    InputStream.mark(int), IOException
  - близко
```
public void close()
           throws IOException
```
    Завершения этот входной поток и выпуски любые системные ресурсы связались с потоком. Как только поток был закрыт, далее считайте (), непрочитанный (), доступный (), сбросьте (), или пропуск (), вызовы бросят IOException. Закрытие ранее закрытого потока не имеет никакого эффекта.
    
    Определенный:
    
    close в интерфейсе Closeable
    
    Определенный:
    
    close в интерфейсе AutoCloseable
    
    Переопределения:
    
    close в class FilterInputStream
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит.
    
    См. Также:
    
    FilterInputStream.in

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Класс PushbackInputStream

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

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

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

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

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

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

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

buf

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

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

PushbackInputStream

PushbackInputStream

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

читать

читать

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

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

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

доступный

пропустить

markSupported

метка

сброс

близко