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

Все Суперинтерфейсы:

AutoCloseable, Closeable, DataInput

Все Известные Подынтерфейсы:

ImageOutputStream

Все Известные Классы с реализацией:

FileCacheImageInputStream, FileCacheImageOutputStream, FileImageInputStream, FileImageOutputStream, ImageInputStreamImpl, ImageOutputStreamImpl, MemoryCacheImageInputStream, MemoryCacheImageOutputStream
```
public interface ImageInputStream
extends DataInput, Closeable
```
Входной поток seekable взаимодействует через интерфейс для использования ImageReaders. Различные входные источники, такой как InputStreams и Files, так же как будущие быстрые источники ввода-вывода может быть "обернут" подходящей реализацией этого интерфейса для использования API ввода-вывода Изображения.

См. Также:

ImageInputStreamImpl, FileImageInputStream, FileCacheImageInputStream, MemoryCacheImageInputStream

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

Все Методы Методы экземпляра Абстрактные Методы
Модификатор и Тип	Метод и Описание
`void`	`close()` Закрывает поток.
`void`	`flush()` Отбрасывает начальную позицию потока до текущей потоковой позиции.
`void`	`flushBefore(long pos)` Отбрасывает начальную часть потока до обозначенного постиона.
`int`	`getBitOffset()` Возвращает текущее разрядное смещение, как целое число между 0 и 7, включительно.
`ByteOrder`	`getByteOrder()` Возвращает порядок байтов, с которым значения данных будут считаны из этого потока как экземпляр `java.nio.ByteOrder` перечисление.
`long`	`getFlushedPosition()` Возвращает самую раннюю позицию в потоке, к которому может быть выполнен поиск.
`long`	`getStreamPosition()` Возвращает текущую позицию байта потока.
`boolean`	`isCached()` Возвраты `true` если это `ImageInputStream` данные кэшей непосредственно, чтобы позволить искать назад.
`boolean`	`isCachedFile()` Возвраты `true` если это `ImageInputStream` данные кэшей непосредственно, чтобы позволить искать назад, и кэш, сохраняются во временном файле.
`boolean`	`isCachedMemory()` Возвраты `true` если это `ImageInputStream` данные кэшей непосредственно, чтобы позволить искать назад, и кэш, сохраняются в оперативной памяти.
`long`	`length()` Возвращает полную длину потока, если известный.
`void`	`mark()` Отмечает позицию в потоке, который будет возвращен к последующим звонком `reset`.
`int`	`read()` Читает единственный байт из потока и возвращает это как целое число между 0 и 255.
`int`	`read(byte[] b)` Чтения до `b.length` байты от потока, и хранят их в `b` запуск в индексирует 0.
`int`	`read(byte[] b, int off, int len)` Чтения до `len` байты от потока, и хранят их в `b` запуск в индексирует `off`.
`int`	`readBit()` Читает единственный бит из потока и возвращает это как `int` со значением `0` или `1`.
`long`	`readBits(int numBits)` Читает строку битов из потока и возвращает это как a `long`, с первым разрядным чтением, становящимся старшим значащим битом вывода.
`boolean`	`readBoolean()` Читает байт из потока и возвращает a `boolean` значение `true` если это является ненулевым, `false` если это - нуль.
`byte`	`readByte()` Читает байт из потока и возвращает это как a `byte` значение.
`void`	`readBytes(IIOByteBuffer buf, int len)` Чтения до `len` байты от потока, и изменяют предоставленный `IIOByteBuffer` чтобы указать на байтовый массив, сместите, и длина, где данные могут быть найдены.
`char`	`readChar()` Эквивалентный `readUnsignedShort`, за исключением того, что результат возвращается, используя `char` тип данных.
`double`	`readDouble()` Чтения 8 байтов от потока, и (концептуально) связывают их согласно текущему порядку байтов и возвращают результат как a `double`.
`float`	`readFloat()` Чтения 4 байта от потока, и (концептуально) связывают их согласно текущему порядку байтов и возвращают результат как a `float`.
`void`	`readFully(byte[] b)` Чтения `b.length` байты от потока, и хранят их в `b` запуск в индексирует `0`.
`void`	`readFully(byte[] b, int off, int len)` Чтения `len` байты от потока, и хранят их в `b` запуск в индексирует `off`.
`void`	`readFully(char[] c, int off, int len)` Чтения `len` случайные работы (16-разрядные целые числа без знака) от потока согласно текущему порядку байтов, и хранят их в `c` запуск в индексирует `off`.
`void`	`readFully(double[] d, int off, int len)` Чтения `len` удваивается (64-разрядные плавания двойной точности IEEE) от потока согласно текущему порядку байтов, и хранит их в `d` запуск в индексирует `off`.
`void`	`readFully(float[] f, int off, int len)` Чтения `len` плавания (32-разрядные плавания одинарной точности IEEE) от потока согласно текущему порядку байтов, и хранят их в `f` запуск в индексирует `off`.
`void`	`readFully(int[] i, int off, int len)` Чтения `len` ints (подписал 32-разрядные целые числа) от потока согласно текущему порядку байтов, и хранит их в `i` запуск в индексирует `off`.
`void`	`readFully(long[] l, int off, int len)` Чтения `len` longs (подписал 64-разрядные целые числа) от потока согласно текущему порядку байтов, и хранит их в `l` запуск в индексирует `off`.
`void`	`readFully(short[] s, int off, int len)` Чтения `len` шорты (подписал 16-разрядные целые числа) от потока согласно текущему порядку байтов, и хранят их в `s` запуск в индексирует `off`.
`int`	`readInt()` Чтения 4 байта от потока, и (концептуально) связывают их согласно текущему порядку байтов и возвращают результат как `int`.
`Строка`	`readLine()` Читает следующую строку текста от входного потока.
`long`	`readLong()` Чтения 8 байтов от потока, и (концептуально) связывают их согласно текущему порядку байтов и возвращают результат как a `long`.
`short`	`readShort()` Чтения два байта от потока, и (концептуально) связывают их согласно текущему порядку байтов, и возвращают результат как a `short` значение.
`int`	`readUnsignedByte()` Читает байт из потока, и (концептуально) преобразовывает это в интервал, маскирует это с `0xff` чтобы снять изоляцию с любых битов расширения знака, и возвратов это как a `byte` значение.
`long`	`readUnsignedInt()` Чтения 4 байта от потока, и (концептуально) связывают их согласно текущему порядку байтов, преобразовывают результат в длинное, маски это с `0xffffffffL` чтобы снять изоляцию с любых битов расширения знака, и возвратов результат как без знака `long` значение.
`int`	`readUnsignedShort()` Чтения два байта от потока, и (концептуально) связывают их согласно текущему порядку байтов, преобразовывают получающееся значение в `int`, маскирует это с `0xffff` чтобы снять изоляцию с любого расширения знака buts, и возвратов результат как без знака `int` значение.
`Строка`	`readUTF()` Чтения в строке, которая была закодирована, используя измененный формат UTF-8.
`void`	`reset()` Возвращает потоковый указатель на его предыдущую позицию, включая разрядное смещение, во время нового несогласованного звонка `mark`.
`void`	`seek(long pos)` Устанавливает текущую потоковую позицию в требуемое расположение.
`void`	`setBitOffset(int bitOffset)` Устанавливает разрядное смещение в целое число между 0 и 7, включительно.
`void`	`setByteOrder(ByteOrder byteOrder)` Устанавливает требуемый порядок байтов для будущих чтений значений данных от этого потока.
`int`	`skipBytes(int n)` Перемещает потоковую позицию вперед данным числом байтов.
`long`	`skipBytes(long n)` Перемещает потоковую позицию вперед данным числом байтов.

- Деталь метода
  - setByteOrder
```
void setByteOrder(ByteOrder byteOrder)
```
    Устанавливает требуемый порядок байтов для будущих чтений значений данных от этого потока. Например, у последовательности байтов '0x01 0x02 0x03 0x04' если бы считано как 4-байтовое целое число было бы значение '0x01020304' использующий сетевой порядок байтов и значение '0x04030201' под обратным порядком байтов.
    Перечисление class java.nio.ByteOrder используется, чтобы определить порядок байтов. Значение ByteOrder.BIG_ENDIAN определяет так называемый или сетевой порядок байтов с обратным порядком байтов, в котором на первом месте байт старшего разряда. Motorola и процессоры Sparc хранят данные в этом формате, в то время как процессоры Intel хранят данные в реверсе ByteOrder.LITTLE_ENDIAN порядок.
    Порядок байтов не имеет никакого эффекта на результаты, возвращенные из readBits метод (или значение, записанное ImageOutputStream.writeBits).
    
    Параметры:
    
    byteOrder - один из ByteOrder.BIG_ENDIAN или java.nio.ByteOrder.LITTLE_ENDIAN, указание, будут ли сетевой порядок байтов или его реверс использоваться для будущих чтений.
    
    См. Также:
    
    ByteOrder, getByteOrder(), readBits(int)
  - getByteOrder
```
ByteOrder getByteOrder()
```
    Возвращает порядок байтов, с которым значения данных будут считаны из этого потока как экземпляр java.nio.ByteOrder перечисление.
    
    Возвраты:
    
    один из ByteOrder.BIG_ENDIAN или ByteOrder.LITTLE_ENDIAN, указание, какой порядок байтов используется.
    
    См. Также:
    
    ByteOrder, setByteOrder(java.nio.ByteOrder)
  - читать
```
int read()
  throws IOException
```
    Читает единственный байт из потока и возвращает это как целое число между 0 и 255. Если конец потока достигается,-1 возвращается.
    Разрядное смещение в потоке сбрасывается, чтобы обнулить прежде, чем чтение произойдет.
    
    Возвраты:
    
    значение байта от потока, как интервал, или-1, чтобы указать на EOF.
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит.
  - читать
```
int read(byte[] b)
  throws IOException
```
    Чтения до b.length байты от потока, и хранят их в b запуск в индексирует 0. Число чтения байтов возвращается. Если никакие байты не могут быть считаны, потому что конец потока был достигнут,-1 возвращается.
    Разрядное смещение в потоке сбрасывается, чтобы обнулить прежде, чем чтение произойдет.
    
    Параметры:
    
    b - массив байтов, которые будут записаны.
    
    Возвраты:
    
    число байтов фактически читало, или -1 указать на EOF.
    
    Броски:
    
    NullPointerException - если b null.
    
    IOException - если ошибка ввода-вывода происходит.
  - читать
```
int read(byte[] b,
         int off,
         int len)
  throws IOException
```
    Чтения до len байты от потока, и хранят их в b запуск в индексирует off. Число чтения байтов возвращается. Если никакие байты не могут быть считаны, потому что конец потока был достигнут, -1 возвращается.
    Разрядное смещение в потоке сбрасывается, чтобы обнулить прежде, чем чтение произойдет.
    
    Параметры:
    
    b - массив байтов, которые будут записаны.
    
    off - стартовая позиция в пределах b записать в.
    
    len - максимальное количество bytes, чтобы читать.
    
    Возвраты:
    
    число байтов фактически читало, или -1 указать на EOF.
    
    Броски:
    
    NullPointerException - если b null.
    
    IndexOutOfBoundsException - если off отрицательно, len отрицательно, или off + len больше чем b.length.
    
    IOException - если ошибка ввода-вывода происходит.
  - readBytes
```
void readBytes(IIOByteBuffer buf,
               int len)
        throws IOException
```
    Чтения до len байты от потока, и изменяют предоставленный IIOByteBuffer чтобы указать на байтовый массив, сместите, и длина, где данные могут быть найдены. Вызывающая сторона не должна попытаться изменить данные, найденные в IIOByteBuffer.
    Разрядное смещение в потоке сбрасывается, чтобы обнулить прежде, чем чтение произойдет.
    
    Параметры:
    
    buf - IIOByteBuffer возражает, чтобы быть измененным.
    
    len - максимальное количество bytes, чтобы читать.
    
    Броски:
    
    IndexOutOfBoundsException - если len отрицательно.
    
    NullPointerException - если buf null.
    
    IOException - если ошибка ввода-вывода происходит.
  - readBoolean
```
boolean readBoolean()
             throws IOException
```
    Читает байт из потока и возвращает a boolean значение true если это является ненулевым, false если это - нуль.
    Разрядное смещение в потоке сбрасывается, чтобы обнулить прежде, чем чтение произойдет.
    
    Определенный:
    
    readBoolean в интерфейсе DataInput
    
    Возвраты:
    
    булево значение от потока.
    
    Броски:
    
    EOFException - если конец потока достигается.
    
    IOException - если ошибка ввода-вывода происходит.
  - readByte
```
byte readByte()
       throws IOException
```
    Читает байт из потока и возвращает это как a byte значение. Байт оценивает между 0x00 и 0x7f представьте целочисленные значения между 0 и 127. Значения между 0x80 и 0xff представьте отрицательные величины от -128 к /1.
    Разрядное смещение в потоке сбрасывается, чтобы обнулить прежде, чем чтение произойдет.
    
    Определенный:
    
    readByte в интерфейсе DataInput
    
    Возвраты:
    
    подписанный байт оценивает от потока.
    
    Броски:
    
    EOFException - если конец потока достигается.
    
    IOException - если ошибка ввода-вывода происходит.
  - readUnsignedByte
```
int readUnsignedByte()
              throws IOException
```
    Читает байт из потока, и (концептуально) преобразовывает это в интервал, маскирует это с 0xff чтобы снять изоляцию с любых битов расширения знака, и возвратов это как a byte значение.
    Таким образом байт оценивает между 0x00 и 0x7f просто возвращаются как целочисленные значения между 0 и 127. Значения между 0x80 и 0xff, которые обычно представляют отрицательный byteзначения, будет отображен в положительные целые числа между 128 и 255.
    Разрядное смещение в потоке сбрасывается, чтобы обнулить прежде, чем чтение произойдет.
    
    Определенный:
    
    readUnsignedByte в интерфейсе DataInput
    
    Возвраты:
    
    байт без знака оценивает от потока.
    
    Броски:
    
    EOFException - если конец потока достигается.
    
    IOException - если ошибка ввода-вывода происходит.
  - readShort
```
short readShort()
         throws IOException
```
    Чтения два байта от потока, и (концептуально) связывают их согласно текущему порядку байтов, и возвращают результат как a short значение.
    Разрядное смещение в потоке сбрасывается, чтобы обнулить прежде, чем чтение произойдет.
    
    Определенный:
    
    readShort в интерфейсе DataInput
    
    Возвраты:
    
    подписанное короткое значение от потока.
    
    Броски:
    
    EOFException - если поток достигает конца прежде, чем считать все байты.
    
    IOException - если ошибка ввода-вывода происходит.
    
    См. Также:
    
    getByteOrder()
  - readUnsignedShort
```
int readUnsignedShort()
               throws IOException
```
    Чтения два байта от потока, и (концептуально) связывают их согласно текущему порядку байтов, преобразовывают получающееся значение в int, маскирует это с 0xffff чтобы снять изоляцию с любого расширения знака buts, и возвратов результат как без знака int значение.
    Разрядное смещение в потоке сбрасывается, чтобы обнулить прежде, чем чтение произойдет.
    
    Определенный:
    
    readUnsignedShort в интерфейсе DataInput
    
    Возвраты:
    
    значение короткого целого без знака от потока, как интервал.
    
    Броски:
    
    EOFException - если поток достигает конца прежде, чем считать все байты.
    
    IOException - если ошибка ввода-вывода происходит.
    
    См. Также:
    
    getByteOrder()
  - readChar
```
char readChar()
       throws IOException
```
    Эквивалентный readUnsignedShort, за исключением того, что результат возвращается, используя char тип данных.
    Разрядное смещение в потоке сбрасывается, чтобы обнулить прежде, чем чтение произойдет.
    
    Определенный:
    
    readChar в интерфейсе DataInput
    
    Возвраты:
    
    случайная работа без знака оценивает от потока.
    
    Броски:
    
    EOFException - если поток достигает конца прежде, чем считать все байты.
    
    IOException - если ошибка ввода-вывода происходит.
    
    См. Также:
    
    readUnsignedShort()
  - readInt
```
int readInt()
     throws IOException
```
    Чтения 4 байта от потока, и (концептуально) связывают их согласно текущему порядку байтов и возвращают результат как int.
    Разрядное смещение в потоке игнорируется и обрабатывается, как если бы это был нуль.
    
    Определенный:
    
    readInt в интерфейсе DataInput
    
    Возвраты:
    
    подписанное международное значение от потока.
    
    Броски:
    
    EOFException - если поток достигает конца прежде, чем считать все байты.
    
    IOException - если ошибка ввода-вывода происходит.
    
    См. Также:
    
    getByteOrder()
  - readUnsignedInt
```
long readUnsignedInt()
              throws IOException
```
    Чтения 4 байта от потока, и (концептуально) связывают их согласно текущему порядку байтов, преобразовывают результат в длинное, маски это с 0xffffffffL чтобы снять изоляцию с любых битов расширения знака, и возвратов результат как без знака long значение.
    Разрядное смещение в потоке сбрасывается, чтобы обнулить прежде, чем чтение произойдет.
    
    Возвраты:
    
    международное значение без знака от потока, как длинное.
    
    Броски:
    
    EOFException - если поток достигает конца прежде, чем считать все байты.
    
    IOException - если ошибка ввода-вывода происходит.
    
    См. Также:
    
    getByteOrder()
  - readLong
```
long readLong()
       throws IOException
```
    Чтения 8 байтов от потока, и (концептуально) связывают их согласно текущему порядку байтов и возвращают результат как a long.
    Разрядное смещение в потоке сбрасывается, чтобы обнулить прежде, чем чтение произойдет.
    
    Определенный:
    
    readLong в интерфейсе DataInput
    
    Возвраты:
    
    подписываемое длинное значение от потока.
    
    Броски:
    
    EOFException - если поток достигает конца прежде, чем считать все байты.
    
    IOException - если ошибка ввода-вывода происходит.
    
    См. Также:
    
    getByteOrder()
  - readFloat
```
float readFloat()
         throws IOException
```
    Чтения 4 байта от потока, и (концептуально) связывают их согласно текущему порядку байтов и возвращают результат как a float.
    Разрядное смещение в потоке сбрасывается, чтобы обнулить прежде, чем чтение произойдет.
    
    Определенный:
    
    readFloat в интерфейсе DataInput
    
    Возвраты:
    
    значение плавающее от потока.
    
    Броски:
    
    EOFException - если поток достигает конца прежде, чем считать все байты.
    
    IOException - если ошибка ввода-вывода происходит.
    
    См. Также:
    
    getByteOrder()
  - readDouble
```
double readDouble()
           throws IOException
```
    Чтения 8 байтов от потока, и (концептуально) связывают их согласно текущему порядку байтов и возвращают результат как a double.
    Разрядное смещение в потоке сбрасывается, чтобы обнулить прежде, чем чтение произойдет.
    
    Определенный:
    
    readDouble в интерфейсе DataInput
    
    Возвраты:
    
    двойное значение от потока.
    
    Броски:
    
    EOFException - если поток достигает конца прежде, чем считать все байты.
    
    IOException - если ошибка ввода-вывода происходит.
    
    См. Также:
    
    getByteOrder()
  - readLine
```
String readLine()
         throws IOException
```
    Читает следующую строку текста от входного потока. Это читает последовательные байты, преобразовывая каждый байт отдельно в символ, пока это не встречается с разделителем строки или концом файла; чтение символов тогда возвращается как a String. Отметьте, что, потому что этот метод обрабатывает байты, он не поддерживает ввод полного набора символов Unicode.
    Если с концом файла встречаются прежде, чем даже один байт может быть считан, то null возвращается. Иначе, каждый байт, который читается, преобразовывается в тип char дополнением нулями. Если символ '\n' встречается, это отбрасывается, и чтение прекращается. Если символ '\r' встречается, это отбрасывается и, если следующий байт преобразовывает в символ '\n', тогда это отбрасывается также; чтение тогда прекращается. Если с концом файла встречаются перед любым из символов '\n' и '\r' встречается, чтение прекращается. Как только чтение прекратилось, a String возвращается, который содержит все чтение символов и не отброшенный, взятый в порядке. Отметьте, что у каждого символа в этой строке будет значение меньше чем \u0100, то есть, (char)256.
    Разрядное смещение в потоке сбрасывается, чтобы обнулить прежде, чем чтение произойдет.
    
    Определенный:
    
    readLine в интерфейсе DataInput
    
    Возвраты:
    
    Строка, содержащая строку текста от потока.
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит.
  - readUTF
```
String readUTF()
        throws IOException
```
    Чтения в строке, которая была закодирована, используя измененный формат UTF-8. Общий контракт readUTF это, это читает представление символьной строки Unicode, закодированной в измененном формате UTF-8; эта строка символов тогда возвращается как a String.
    Во-первых, два байта читаются и используются, чтобы создать 16-разрядное целое число без знака таким образом readUnsignedShort метод, используя сетевой порядок байтов (независимо от текущей установки порядка байтов). Это целочисленное значение вызывают длиной UTF и определяет число дополнительных байтов, которые будут считаны. Эти байты тогда преобразовываются в символы, рассматривая их в группах. Длина каждой группы вычисляется от значения первого байта группы. Байт после группы, если таковые вообще имеются, является первым байтом следующей группы.
    Если первый байт группы соответствует комбинацию двоичных разрядов 0xxxxxxx (где x означает, "может быть 0 или 1"), тогда группа состоит из только того байта. Байт расширяется до нуля, чтобы сформировать символ.
    Если первый байт группы соответствует комбинацию двоичных разрядов 110xxxxx, тогда группа состоит из того байта a и второй байт b. Если нет никакого байта b (потому что байт a был последний из байтов, которые будут считаны), или если байт b не соответствует комбинацию двоичных разрядов 10xxxxxx, тогда a UTFDataFormatException бросается. Иначе, группа преобразовывается в символ:
```
 (char)(((a& 0x1F) << 6) | (b & 0x3F))
 
```
    Если первый байт группы соответствует комбинацию двоичных разрядов 1110xxxx, тогда группа состоит из того байта a и еще два байта b и c. Если нет никакого байта c (потому что байт a был один из последних двух из байтов, которые будут считаны), или любой байт b или байт c не соответствует комбинацию двоичных разрядов 10xxxxxx, тогда a UTFDataFormatException бросается. Иначе, группа преобразовывается в символ:
```
 (char)(((a & 0x0F) << 12) | ((b & 0x3F) << 6) | (c & 0x3F))
 
```
    Если первый байт группы соответствует образец 1111xxxx или образец 10xxxxxx, тогда a UTFDataFormatException бросается.
    Если с концом файла встречаются в любое время во время этого всего процесса, то EOFException бросается.
    После того, как каждая группа была преобразована в символ этим процессом, символы собираются в том же самом порядке, в котором их соответствующие группы были считаны из входного потока, чтобы сформировать a String, который возвращается.
    Текущая установка порядка байтов игнорируется.
    Разрядное смещение в потоке сбрасывается, чтобы обнулить прежде, чем чтение произойдет.
    Отметьте: Этот метод не должен использоваться в реализации форматов изображения, которые используют стандартный UTF-8, потому что измененный UTF-8, используемый здесь, является несовместимым со стандартным UTF-8.
    Определенный:
    
    readUTF в интерфейсе DataInput
    
    Возвраты:
    
    Строка читала из потока.
    
    Броски:
    
    EOFException - если этот поток достигает конца прежде, чем считать все байты.
    
    UTFDataFormatException - если байты не представляют допустимое измененное кодирование UTF-8 строки.
    
    IOException - если ошибка ввода-вывода происходит.
  - readFully
```
void readFully(byte[] b,
               int off,
               int len)
        throws IOException
```
    Чтения len байты от потока, и хранят их в b запуск в индексирует off. Если конец потока достигается, EOFException будет брошен.
    Разрядное смещение в потоке сбрасывается, чтобы обнулить прежде, чем чтение произойдет.
    
    Определенный:
    
    readFully в интерфейсе DataInput
    
    Параметры:
    
    b - массив байтов, которые будут записаны.
    
    off - стартовая позиция в пределах b записать в.
    
    len - максимальное количество bytes, чтобы читать.
    
    Броски:
    
    IndexOutOfBoundsException - если off отрицательно, len отрицательно, или off + len больше чем b.length.
    
    NullPointerException - если b null.
    
    EOFException - если поток достигает конца прежде, чем считать все байты.
    
    IOException - если ошибка ввода-вывода происходит.
  - readFully
```
void readFully(byte[] b)
        throws IOException
```
    Чтения b.length байты от потока, и хранят их в b запуск в индексирует 0. Если конец потока достигается, EOFException будет брошен.
    Разрядное смещение в потоке сбрасывается, чтобы обнулить прежде, чем чтение произойдет.
    
    Определенный:
    
    readFully в интерфейсе DataInput
    
    Параметры:
    
    b - массив bytes.
    
    Броски:
    
    NullPointerException - если b null.
    
    EOFException - если поток достигает конца прежде, чем считать все байты.
    
    IOException - если ошибка ввода-вывода происходит.
  - readFully
```
void readFully(short[] s,
               int off,
               int len)
        throws IOException
```
    Чтения len шорты (подписал 16-разрядные целые числа) от потока согласно текущему порядку байтов, и хранят их в s запуск в индексирует off. Если конец потока достигается, EOFException будет брошен.
    Разрядное смещение в потоке сбрасывается, чтобы обнулить прежде, чем чтение произойдет.
    
    Параметры:
    
    s - массив шорт, которые будут записаны.
    
    off - стартовая позиция withinb, чтобы записать в.
    
    len - максимальное количество shorts, чтобы читать.
    
    Броски:
    
    IndexOutOfBoundsException - если off отрицательно, len отрицательно, или off + len больше чем s.length.
    
    NullPointerException - если s null.
    
    EOFException - если поток достигает конца прежде, чем считать все байты.
    
    IOException - если ошибка ввода-вывода происходит.
  - readFully
```
void readFully(char[] c,
               int off,
               int len)
        throws IOException
```
    Чтения len случайные работы (16-разрядные целые числа без знака) от потока согласно текущему порядку байтов, и хранят их в c запуск в индексирует off. Если конец потока достигается, EOFException будет брошен.
    Разрядное смещение в потоке сбрасывается, чтобы обнулить прежде, чем чтение произойдет.
    
    Параметры:
    
    c - массив случайных работ, которые будут записаны.
    
    off - стартовая позиция withinb, чтобы записать в.
    
    len - максимальное количество chars, чтобы читать.
    
    Броски:
    
    IndexOutOfBoundsException - если off отрицательно, len отрицательно, или off + len больше чем c.length.
    
    NullPointerException - если c null.
    
    EOFException - если поток достигает конца прежде, чем считать все байты.
    
    IOException - если ошибка ввода-вывода происходит.
  - readFully
```
void readFully(int[] i,
               int off,
               int len)
        throws IOException
```
    Чтения len ints (подписал 32-разрядные целые числа) от потока согласно текущему порядку байтов, и хранит их в i запуск в индексирует off. Если конец потока достигается, EOFException будет брошен.
    Разрядное смещение в потоке сбрасывается, чтобы обнулить прежде, чем чтение произойдет.
    
    Параметры:
    
    i - массив ints, который будет записан.
    
    off - стартовая позиция withinb, чтобы записать в.
    
    len - максимальное количество ints, чтобы читать.
    
    Броски:
    
    IndexOutOfBoundsException - если off отрицательно, len отрицательно, или off + len больше чем i.length.
    
    NullPointerException - если i null.
    
    EOFException - если поток достигает конца прежде, чем считать все байты.
    
    IOException - если ошибка ввода-вывода происходит.
  - readFully
```
void readFully(long[] l,
               int off,
               int len)
        throws IOException
```
    Чтения len longs (подписал 64-разрядные целые числа) от потока согласно текущему порядку байтов, и хранит их в l запуск в индексирует off. Если конец потока достигается, EOFException будет брошен.
    Разрядное смещение в потоке сбрасывается, чтобы обнулить прежде, чем чтение произойдет.
    
    Параметры:
    
    l - массив longs, который будет записан.
    
    off - стартовая позиция withinb, чтобы записать в.
    
    len - максимальное количество longs, чтобы читать.
    
    Броски:
    
    IndexOutOfBoundsException - если off отрицательно, len отрицательно, или off + len больше чем l.length.
    
    NullPointerException - если l null.
    
    EOFException - если поток достигает конца прежде, чем считать все байты.
    
    IOException - если ошибка ввода-вывода происходит.
  - readFully
```
void readFully(float[] f,
               int off,
               int len)
        throws IOException
```
    Чтения len плавания (32-разрядные плавания одинарной точности IEEE) от потока согласно текущему порядку байтов, и хранят их в f запуск в индексирует off. Если конец потока достигается, EOFException будет брошен.
    Разрядное смещение в потоке сбрасывается, чтобы обнулить прежде, чем чтение произойдет.
    
    Параметры:
    
    f - массив плаваний, которые будут записаны.
    
    off - стартовая позиция withinb, чтобы записать в.
    
    len - максимальное количество floats, чтобы читать.
    
    Броски:
    
    IndexOutOfBoundsException - если off отрицательно, len отрицательно, или off + len больше чем f.length.
    
    NullPointerException - если f null.
    
    EOFException - если поток достигает конца прежде, чем считать все байты.
    
    IOException - если ошибка ввода-вывода происходит.
  - readFully
```
void readFully(double[] d,
               int off,
               int len)
        throws IOException
```
    Чтения len удваивается (64-разрядные плавания двойной точности IEEE) от потока согласно текущему порядку байтов, и хранит их в d запуск в индексирует off. Если конец потока достигается, EOFException будет брошен.
    Разрядное смещение в потоке сбрасывается, чтобы обнулить прежде, чем чтение произойдет.
    
    Параметры:
    
    d - массив удваивается, чтобы быть записанным.
    
    off - стартовая позиция withinb, чтобы записать в.
    
    len - максимальное количество doubles, чтобы читать.
    
    Броски:
    
    IndexOutOfBoundsException - если off отрицательно, len отрицательно, или off + len больше чем d.length.
    
    NullPointerException - если d null.
    
    EOFException - если поток достигает конца прежде, чем считать все байты.
    
    IOException - если ошибка ввода-вывода происходит.
  - getStreamPosition
```
long getStreamPosition()
                throws IOException
```
    Возвращает текущую позицию байта потока. Следующее чтение будет иметь место, запускаясь при этом смещении.
    
    Возвраты:
    
    длинное, содержащее позицию потока.
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит.
  - getBitOffset
```
int getBitOffset()
          throws IOException
```
    Возвращает текущее разрядное смещение, как целое число между 0 и 7, включительно. Разрядное смещение обновляется неявно звонками readBits метод. Значение 0 указывает на старший значащий бит, и значение 7 указывает на младший значащий бит считанного байта.
    Разрядное смещение устанавливается в 0, когда поток сначала открывается, и сбрасывается к 0 звонками seek, skipBytes, или любой read или readFully метод.
    
    Возвраты:
    
    int содержа разрядное смещение между 0 и 7, включительно.
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит.
    
    См. Также:
    
    setBitOffset(int)
  - setBitOffset
```
void setBitOffset(int bitOffset)
           throws IOException
```
    Устанавливает разрядное смещение в целое число между 0 и 7, включительно. Байтовое смещение в потоке, как возвращено getStreamPosition, оставляется неизменным. Значение 0 указывает на старший значащий бит, и значение 7 указывает на младший значащий бит считанного байта.
    
    Параметры:
    
    bitOffset - требуемое смещение, как int между 0 и 7, включительно.
    
    Броски:
    
    IllegalArgumentException - если bitOffset не между 0 и 7, включительно.
    
    IOException - если ошибка ввода-вывода происходит.
    
    См. Также:
    
    getBitOffset()
  - readBit
```
int readBit()
     throws IOException
```
    Читает единственный бит из потока и возвращает это как int со значением 0 или 1. Разрядное смещение совершенствуется одним и уменьшало по модулю 8.
    
    Возвраты:
    
    int содержа значение 0 или 1.
    
    Броски:
    
    EOFException - если поток достигает конца прежде, чем считать все биты.
    
    IOException - если ошибка ввода-вывода происходит.
  - readBits
```
long readBits(int numBits)
       throws IOException
```
    Читает строку битов из потока и возвращает это как a long, с первым разрядным чтением, становящимся старшим значащим битом вывода. Чтение запускается в пределах байта, обозначенного getStreamPosition, в бите, данном getBitOffset. Разрядное смещение совершенствуется numBits и уменьшенный по модулю 8.
    Порядок байтов потока не имеет никакого эффекта на этот метод. Возвращаемое значение этого метода создается, как если бы биты были считаны по одному, и смещались в правую сторону возвращаемого значения, как показано следующим псевдокодом:
```
 long accum = 0L;
 for (int i = 0; i < numBits i accum ="1;" Shift left one bit to make room accum ="readBit();" pre>

 Note that the result of readBits(32) may thus not
 be equal to that of readInt() if a reverse network
 byte order is being used (i.e., getByteOrder() ==
 false).

  If the end of the stream is encountered before all the bits
 have been read, an EOFException is thrown.
```
    Parameters:
    
    numBits - the number of bits to read, as an int between 0 and 64, inclusive.
    
    Returns:
    
    the bitstring, as a long with the last bit read stored in the least significant bit.
    
    Throws:
    
    IllegalArgumentException - if numBits is not between 0 and 64, inclusive.
    
    EOFException - if the stream reaches the end before reading all the bits.
    
    IOException - if an I/O error occurs.
  - length
```
long length()
     throws IOException
```
    Returns the total length of the stream, if known. Otherwise, -1 is returned.
    
    Returns:
    
    a long containing the length of the stream, if known, or else -1.
    
    Throws:
    
    IOException - if an I/O error occurs.
  - skipBytes
```
int skipBytes(int n)
       throws IOException
```
    Moves the stream position forward by a given number of bytes. It is possible that this method will only be able to skip forward by a smaller number of bytes than requested, for example if the end of the stream is reached. In all cases, the actual number of bytes skipped is returned. The bit offset is set to zero prior to advancing the position.
    
    Specified by:
    
    skipBytes in interface DataInput
    
    Parameters:
    
    n - an int containing the number of bytes to be skipped.
    
    Returns:
    
    an int representing the number of bytes skipped.
    
    Throws:
    
    IOException - if an I/O error occurs.
  - skipBytes
```
long skipBytes(long n)
        throws IOException
```
    Moves the stream position forward by a given number of bytes. This method is identical to skipBytes(int) except that it allows for a larger skip distance.
    
    Parameters:
    
    n - a long containing the number of bytes to be skipped.
    
    Returns:
    
    a long representing the number of bytes skipped.
    
    Throws:
    
    IOException - if an I/O error occurs.
  - seek
```
void seek(long pos)
   throws IOException
```
    Sets the current stream position to the desired location. The next read will occur at this location. The bit offset is set to 0.
    An IndexOutOfBoundsException will be thrown if pos is smaller than the flushed position (as returned by getflushedPosition).
    It is legal to seek past the end of the file; an EOFException will be thrown only if a read is performed.
    
    Parameters:
    
    pos - a long containing the desired file pointer position.
    
    Throws:
    
    IndexOutOfBoundsException - if pos is smaller than the flushed position.
    
    IOException - if any other I/O error occurs.
  - mark
```
void mark()
```
    Marks a position in the stream to be returned to by a subsequent call to reset. Unlike a standard InputStream, all ImageInputStreams support marking. Additionally, calls to mark and reset may be nested arbitrarily.
    Unlike the mark methods declared by the Reader and InputStream interfaces, no readLimit parameter is used. An arbitrary amount of data may be read following the call to mark.
    The bit position used by the readBits method is saved and restored by each pair of calls to mark and reset.
    Note that it is valid for an ImageReader to call flushBefore as part of a read operation. Therefore, if an application calls mark prior to passing that stream to an ImageReader, the application should not assume that the marked position will remain valid after the read operation has completed.
  - reset
```
void reset()
    throws IOException
```
    Returns the stream pointer to its previous position, including the bit offset, at the time of the most recent unmatched call to mark.
    Calls to reset without a corresponding call to mark have no effect.
    An IOException will be thrown if the previous marked position lies in the discarded portion of the stream.
    
    Throws:
    
    IOException - if an I/O error occurs.
  - flushBefore
```
void flushBefore(long pos)
          throws IOException
```
    Discards the initial portion of the stream prior to the indicated postion. Attempting to seek to an offset within the flushed portion of the stream will result in an IndexOutOfBoundsException.
    Calling flushBefore may allow classes implementing this interface to free up resources such as memory or disk space that are being used to store data from the stream.
    
    Parameters:
    
    pos - a long containing the length of the stream prefix that may be flushed.
    
    Throws:
    
    IndexOutOfBoundsException - if pos lies in the flushed portion of the stream or past the current stream position.
    
    IOException - if an I/O error occurs.
  - flush
```
void flush()
    throws IOException
```
    Discards the initial position of the stream prior to the current stream position. Equivalent to flushBefore(getStreamPosition()).
    
    Throws:
    
    IOException - if an I/O error occurs.
  - getFlushedPosition
```
long getFlushedPosition()
```
    Returns the earliest position in the stream to which seeking may be performed. The returned value will be the maximum of all values passed into previous calls to flushBefore.
    
    Returns:
    
    the earliest legal position for seeking, as a long.
  - isCached
```
boolean isCached()
```
    Returns true if this ImageInputStream caches data itself in order to allow seeking backwards. Applications may consult this in order to decide how frequently, or whether, to flush in order to conserve cache resources.
    
    Returns:
    
    true if this ImageInputStream caches data.
    
    See Also:
    
    isCachedMemory(), isCachedFile()
  - isCachedMemory
```
boolean isCachedMemory()
```
    Returns true if this ImageInputStream caches data itself in order to allow seeking backwards, and the cache is kept in main memory. Applications may consult this in order to decide how frequently, or whether, to flush in order to conserve cache resources.
    
    Returns:
    
    true if this ImageInputStream caches data in main memory.
    
    See Also:
    
    isCached(), isCachedFile()
  - isCachedFile
```
boolean isCachedFile()
```
    Returns true if this ImageInputStream caches data itself in order to allow seeking backwards, and the cache is kept in a temporary file. Applications may consult this in order to decide how frequently, or whether, to flush in order to conserve cache resources.
    
    Returns:
    
    true if this ImageInputStream caches data in a temporary file.
    
    See Also:
    
    isCached(), isCachedMemory()
  - close
```
void close()
    throws IOException
```
    Closes the stream. Attempts to access a stream that has been closed may result in IOExceptions or incorrect behavior. Calling this method may allow classes implementing this interface to release resources associated with the stream such as memory, disk space, or file descriptors.
    
    Specified by:
    
    close in interface AutoCloseable
    
    Specified by:
    
    close in interface Closeable
    
    Throws:
    
    IOException - if an I/O error occurs.

Представьте ошибку или функцию
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.
DRAFT ea-b92

Интерфейс ImageInputStream

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

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

setByteOrder

getByteOrder

читать

читать

читать

readBytes

readBoolean

readByte

readUnsignedByte

readShort

readUnsignedShort

readChar

readInt

readUnsignedInt

readLong

readFloat

readDouble

readLine

readUTF

readFully

readFully

readFully

readFully

readFully

readFully

readFully

readFully

getStreamPosition

getBitOffset

setBitOffset

readBit

readBits

length

skipBytes

skipBytes

seek

mark

reset

flushBefore

flush

getFlushedPosition

isCached

isCachedMemory

isCachedFile

close