DataInputStream (Платформа Java SE 7)

java.lang. Объект
- java.io. InputStream
- - java.io. FilterInputStream
  - - java.io. DataInputStream

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

Closeable, DataInput, AutoCloseable
```
public class DataInputStream
extends FilterInputStream
implements DataInput
```
Поток ввода данных позволяет чтению приложения примитивные типы данных Java от базового входного потока машинно-независимым способом. Приложение использует поток вывода данных, чтобы записать данные, которые могут позже быть считаны потоком ввода данных.
DataInputStream не обязательно безопасен для многопоточного доступа. Потокобезопасность является дополнительной и является ответственностью пользователей методов в этом классе.

С тех пор:

JDK1.0

См. Также:
DataOutputStream

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

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

Конструкторы
Конструктор и Описание
`DataInputStream(InputStream in)` Создает DataInputStream, который использует указанный базовый InputStream.

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

Методы
Модификатор и Тип	Метод и Описание
`int`	`read(byte[] b)` Чтения некоторое число байтов от содержавшего входного потока и хранят их в буферный массив `b`.
`int`	`read(byte[] b, int off, int len)` Чтения до `len` байты данных от содержавшего входного потока в массив байтов.
`boolean`	`readBoolean()` См. общий контракт `readBoolean` метод `DataInput`.
`byte`	`readByte()` См. общий контракт `readByte` метод `DataInput`.
`char`	`readChar()` См. общий контракт `readChar` метод `DataInput`.
`double`	`readDouble()` См. общий контракт `readDouble` метод `DataInput`.
`float`	`readFloat()` См. общий контракт `readFloat` метод `DataInput`.
`void`	`readFully(byte[] b)` См. общий контракт `readFully` метод `DataInput`.
`void`	`readFully(byte[] b, int off, int len)` См. общий контракт `readFully` метод `DataInput`.
`int`	`readInt()` См. общий контракт `readInt` метод `DataInput`.
`Строка`	`readLine()` Осуждаемый. Этот метод должным образом не преобразовывает байты в символы. С JDK 1.1, привилегированный способ считать строки текста через `BufferedReader.readLine()` метод. Программы, которые используют `DataInputStream` строки класса чтения могут быть преобразованы в использование `BufferedReader` класс, заменяя код формы: DataInputStream d = new DataInputStream(in); с: BufferedReader d = new BufferedReader(new InputStreamReader(in));
`long`	`readLong()` См. общий контракт `readLong` метод `DataInput`.
`short`	`readShort()` См. общий контракт `readShort` метод `DataInput`.
`int`	`readUnsignedByte()` См. общий контракт `readUnsignedByte` метод `DataInput`.
`int`	`readUnsignedShort()` См. общий контракт `readUnsignedShort` метод `DataInput`.
`Строка`	`readUTF()` См. общий контракт `readUTF` метод `DataInput`.
`static String`	`readUTF(DataInput in)` Чтения от потока `in` представление символьной строки Unicode закодировано в измененном формате UTF-8; эта строка символов тогда возвращается как a `String`.
`int`	`skipBytes(int n)` См. общий контракт `skipBytes` метод `DataInput`.

Методы java.io унаследованный от класса. FilterInputStream
available, close, mark, markSupported, read, reset, skip

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Деталь конструктора
  - DataInputStream
```
public DataInputStream(InputStream in)
```
    Создает DataInputStream, который использует указанный базовый InputStream.
    
    Параметры:
    in - указанный входной поток
- Деталь метода
  - читать
```
public final int read(byte[] b)
               throws IOException
```
    Чтения некоторое число байтов от содержавшего входного потока и хранят их в буферный массив b. Число байтов фактически чтение возвращается как целое число. Этот метод блоки до входных данных доступен, конец файла обнаруживается, или исключение выдается.
    Если b нуль, a NullPointerException бросается. Если длина b нуль, тогда никакие байты не читаются и 0 возвращается; иначе, есть попытка считать по крайней мере один байт. Если никакой байт не доступен, потому что поток в конце файла, значения -1 возвращается; иначе, по крайней мере один байт читается и сохранен в b.
    Первое побайтовое чтение сохранено в элемент b[0], следующий в b[1], и так далее. Число чтения байтов, самое большее, равно длине b. Позволить k будьте числом байтов фактически чтение; эти байты будут сохранены в элементах b[0] через b[k-1], отъезд элементов b[k] через b[b.length-1] незатронутый.
    read(b) метод имеет тот же самый эффект как:
    read(b, 0, b.length)
    Переопределения:
    
    read в классе FilterInputStream
    
    Параметры:
    b - буфер, в который читаются данные.
    
    Возвраты:
    общее количество чтения байтов в буфер, или -1 если нет больше данных, потому что конец потока был достигнут.
    
    Броски:
    
    IOException - если первый байт не может быть считан ни по какой причине кроме конца файла, поток был закрыт, и базовый входной поток не поддерживает чтение после близко, или другая ошибка ввода-вывода происходит.
    См. Также:
    FilterInputStream.in, InputStream.read(byte[], int, int)
  - читать
```
public final int read(byte[] b,
       int off,
       int len)
               throws IOException
```
    Чтения до len байты данных от содержавшего входного потока в массив байтов. Попытка предпринимается, чтобы читать столько, сколько len байты, но меньшее число могут быть считаны, возможно обнулить. Число байтов фактически чтение возвращается как целое число.
    Этот метод блоки до входных данных доступен, конец файла обнаруживается, или исключение выдается.
    Если len нуль, тогда никакие байты не читаются и 0 возвращается; иначе, есть попытка считать по крайней мере один байт. Если никакой байт не доступен, потому что поток в конце файла, значения -1 возвращается; иначе, по крайней мере один байт читается и сохранен в b.
    Первое побайтовое чтение сохранено в элемент b[off], следующий в b[off+1], и так далее. Число чтения байтов, самое большее, равно len. Позвольте k быть числом байтов фактически чтение; эти байты будут сохранены в элементах b[off] через b[off+k-1], отъезд элементов b[off+k] через b[off+len-1] незатронутый.
    В каждом случае, элементах b[0] через b[off] и элементы b[off+len] через b[b.length-1] незатронуты.
    
    Переопределения:
    
    read в классе FilterInputStream
    
    Параметры:
    b - буфер, в который читаются данные.
    off - запуск смещается в целевом массиве b
    len - максимальное количество байтов читало.
    
    Возвраты:
    общее количество чтения байтов в буфер, или -1 если нет больше данных, потому что конец потока был достигнут.
    
    Броски:
    
    NullPointerException - Если b null.
    
    IndexOutOfBoundsException - Если off отрицательно, len отрицательно, или len больше чем b.length - off
    
    IOException - если первый байт не может быть считан ни по какой причине кроме конца файла, поток был закрыт, и базовый входной поток не поддерживает чтение после близко, или другая ошибка ввода-вывода происходит.
    См. Также:
    FilterInputStream.in, InputStream.read(byte[], int, int)
  - readFully
```
public final void readFully(byte[] b)
                     throws IOException
```
    См. общий контракт readFully метод DataInput.
    Байты для этой работы читаются из содержавшего входного потока.
    
    Определенный:
    
    readFully в интерфейсе DataInput
    
    Параметры:
    b - буфер, в который читаются данные.
    
    Броски:
    
    EOFException - если этот входной поток достигает конца прежде, чем считать все байты.
    
    IOException - поток был закрыт, и содержавший входной поток не поддерживает чтение после близко, или другая ошибка ввода-вывода происходит.
    См. Также:
    FilterInputStream.in
  - readFully
```
public final void readFully(byte[] b,
             int off,
             int len)
                     throws IOException
```
    См. общий контракт readFully метод DataInput.
    Байты для этой работы читаются из содержавшего входного потока.
    
    Определенный:
    
    readFully в интерфейсе DataInput
    
    Параметры:
    b - буфер, в который читаются данные.
    off - смещение запуска данных.
    len - число байтов, чтобы читать.
    
    Броски:
    
    EOFException - если этот входной поток достигает конца прежде, чем считать все байты.
    
    IOException - поток был закрыт, и содержавший входной поток не поддерживает чтение после близко, или другая ошибка ввода-вывода происходит.
    См. Также:
    FilterInputStream.in
  - skipBytes
```
public final int skipBytes(int n)
                    throws IOException
```
    См. общий контракт skipBytes метод DataInput.
    Байты для этой работы читаются из содержавшего входного потока.
    
    Определенный:
    
    skipBytes в интерфейсе DataInput
    
    Параметры:
    n - число байтов, которые будут пропущены.
    
    Возвраты:
    фактическое число байтов пропускается.
    
    Броски:
    
    IOException - если содержавший входной поток не поддерживает, ищут, или поток был закрыт, и содержавший входной поток не поддерживает чтение после близко, или другая ошибка ввода-вывода происходит.
  - readBoolean
```
public final boolean readBoolean()
                          throws IOException
```
    См. общий контракт readBoolean метод DataInput.
    Байты для этой работы читаются из содержавшего входного потока.
    
    Определенный:
    
    readBoolean в интерфейсе DataInput
    
    Возвраты:
    boolean значение читало.
    
    Броски:
    
    EOFException - если этот входной поток достиг конца.
    
    IOException - поток был закрыт, и содержавший входной поток не поддерживает чтение после близко, или другая ошибка ввода-вывода происходит.
    См. Также:
    FilterInputStream.in
  - readByte
```
public final byte readByte()
                    throws IOException
```
    См. общий контракт readByte метод DataInput.
    Байты для этой работы читаются из содержавшего входного потока.
    
    Определенный:
    
    readByte в интерфейсе DataInput
    
    Возвраты:
    следующий байт этого входного потока как 8-разрядное со знаком byte.
    
    Броски:
    
    EOFException - если этот входной поток достиг конца.
    
    IOException - поток был закрыт, и содержавший входной поток не поддерживает чтение после близко, или другая ошибка ввода-вывода происходит.
    См. Также:
    FilterInputStream.in
  - readUnsignedByte
```
public final int readUnsignedByte()
                           throws IOException
```
    См. общий контракт readUnsignedByte метод DataInput.
    Байты для этой работы читаются из содержавшего входного потока.
    
    Определенный:
    
    readUnsignedByte в интерфейсе DataInput
    
    Возвраты:
    следующий байт этого входного потока, интерпретируемого как 8-разрядное число без знака.
    
    Броски:
    
    EOFException - если этот входной поток достиг конца.
    
    IOException - поток был закрыт, и содержавший входной поток не поддерживает чтение после близко, или другая ошибка ввода-вывода происходит.
    См. Также:
    FilterInputStream.in
  - readShort
```
public final short readShort()
                      throws IOException
```
    См. общий контракт readShort метод DataInput.
    Байты для этой работы читаются из содержавшего входного потока.
    
    Определенный:
    
    readShort в интерфейсе DataInput
    
    Возвраты:
    следующие два байта этого входного потока, интерпретируемого как 16-разрядное число со знаком.
    
    Броски:
    
    EOFException - если этот входной поток достигает конца прежде, чем считать два байта.
    
    IOException - поток был закрыт, и содержавший входной поток не поддерживает чтение после близко, или другая ошибка ввода-вывода происходит.
    См. Также:
    FilterInputStream.in
  - readUnsignedShort
```
public final int readUnsignedShort()
                            throws IOException
```
    См. общий контракт readUnsignedShort метод DataInput.
    Байты для этой работы читаются из содержавшего входного потока.
    
    Определенный:
    
    readUnsignedShort в интерфейсе DataInput
    
    Возвраты:
    следующие два байта этого входного потока, интерпретируемого как 16-разрядное целое число без знака.
    
    Броски:
    
    EOFException - если этот входной поток достигает конца прежде, чем считать два байта.
    
    IOException - поток был закрыт, и содержавший входной поток не поддерживает чтение после близко, или другая ошибка ввода-вывода происходит.
    См. Также:
    FilterInputStream.in
  - readChar
```
public final char readChar()
                    throws IOException
```
    См. общий контракт readChar метод DataInput.
    Байты для этой работы читаются из содержавшего входного потока.
    
    Определенный:
    
    readChar в интерфейсе DataInput
    
    Возвраты:
    следующие два байта этого входного потока, интерпретируемого как a char.
    
    Броски:
    
    EOFException - если этот входной поток достигает конца прежде, чем считать два байта.
    
    IOException - поток был закрыт, и содержавший входной поток не поддерживает чтение после близко, или другая ошибка ввода-вывода происходит.
    См. Также:
    FilterInputStream.in
  - readInt
```
public final int readInt()
                  throws IOException
```
    См. общий контракт readInt метод DataInput.
    Байты для этой работы читаются из содержавшего входного потока.
    
    Определенный:
    
    readInt в интерфейсе DataInput
    
    Возвраты:
    следующие четыре байта этого входного потока, интерпретируемого как int.
    
    Броски:
    
    EOFException - если этот входной поток достигает конца прежде, чем считать четыре байта.
    
    IOException - поток был закрыт, и содержавший входной поток не поддерживает чтение после близко, или другая ошибка ввода-вывода происходит.
    См. Также:
    FilterInputStream.in
  - readLong
```
public final long readLong()
                    throws IOException
```
    См. общий контракт readLong метод DataInput.
    Байты для этой работы читаются из содержавшего входного потока.
    
    Определенный:
    
    readLong в интерфейсе DataInput
    
    Возвраты:
    следующие восемь байтов этого входного потока, интерпретируемого как a long.
    
    Броски:
    
    EOFException - если этот входной поток достигает конца прежде, чем считать восемь байтов.
    
    IOException - поток был закрыт, и содержавший входной поток не поддерживает чтение после близко, или другая ошибка ввода-вывода происходит.
    См. Также:
    FilterInputStream.in
  - readFloat
```
public final float readFloat()
                      throws IOException
```
    См. общий контракт readFloat метод DataInput.
    Байты для этой работы читаются из содержавшего входного потока.
    
    Определенный:
    
    readFloat в интерфейсе DataInput
    
    Возвраты:
    следующие четыре байта этого входного потока, интерпретируемого как a float.
    
    Броски:
    
    EOFException - если этот входной поток достигает конца прежде, чем считать четыре байта.
    
    IOException - поток был закрыт, и содержавший входной поток не поддерживает чтение после близко, или другая ошибка ввода-вывода происходит.
    См. Также:
    readInt(), Float.intBitsToFloat(int)
  - readDouble
```
public final double readDouble()
                        throws IOException
```
    См. общий контракт readDouble метод DataInput.
    Байты для этой работы читаются из содержавшего входного потока.
    
    Определенный:
    
    readDouble в интерфейсе DataInput
    
    Возвраты:
    следующие восемь байтов этого входного потока, интерпретируемого как a double.
    
    Броски:
    
    EOFException - если этот входной поток достигает конца прежде, чем считать восемь байтов.
    
    IOException - поток был закрыт, и содержавший входной поток не поддерживает чтение после близко, или другая ошибка ввода-вывода происходит.
    См. Также:
    readLong(), Double.longBitsToDouble(long)
  - readLine
```
@Deprecated
public final String readLine()
                      throws IOException
```
    Осуждаемый. Этот метод должным образом не преобразовывает байты в символы. С JDK 1.1, привилегированный способ считать строки текста через BufferedReader.readLine() метод. Программы, которые используют DataInputStream строки класса чтения могут быть преобразованы в использование BufferedReader класс, заменяя код формы:
    DataInputStream d = new DataInputStream(in);
    с:
    BufferedReader d = new BufferedReader(new InputStreamReader(in));
    См. общий контракт readLine метод DataInput.
    Байты для этой работы читаются из содержавшего входного потока.
    
    Определенный:
    
    readLine в интерфейсе DataInput
    
    Возвраты:
    следующая строка текста от этого входного потока.
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит.
    См. Также:
    BufferedReader.readLine(), FilterInputStream.in
  - readUTF
```
public final String readUTF()
                     throws IOException
```
    См. общий контракт readUTF метод DataInput.
    Байты для этой работы читаются из содержавшего входного потока.
    
    Определенный:
    
    readUTF в интерфейсе DataInput
    
    Возвраты:
    строка Unicode.
    
    Броски:
    
    EOFException - если этот входной поток достигает конца прежде, чем считать все байты.
    
    IOException - поток был закрыт, и содержавший входной поток не поддерживает чтение после близко, или другая ошибка ввода-вывода происходит.
    
    UTFDataFormatException - если байты не представляют допустимое измененное кодирование UTF-8 строки.
    См. Также:
    readUTF(java.io.DataInput)
  - readUTF
```
public static final String readUTF(DataInput in)
                            throws IOException
```
    Чтения от потока in представление символьной строки Unicode закодировано в измененном формате UTF-8; эта строка символов тогда возвращается как a String. Детали измененного представления UTF-8 являются точно тем же самым что касается readUTF метод DataInput.
    
    Параметры:
    in - поток ввода данных.
    
    Возвраты:
    строка Unicode.
    
    Броски:
    
    EOFException - если входной поток достигает конца перед всеми байтами.
    
    IOException - поток был закрыт, и содержавший входной поток не поддерживает чтение после близко, или другая ошибка ввода-вывода происходит.
    
    UTFDataFormatException - если байты не представляют допустимое измененное кодирование UTF-8 строки Unicode.
    См. Также:
    readUnsignedShort()

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

Класс DataInputStream

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

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

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

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

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

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

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

DataInputStream

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

читать

читать

readFully

readFully

skipBytes

readBoolean

readByte

readUnsignedByte

readShort

readUnsignedShort

readChar

readInt

readLong

readFloat

readDouble

readLine

readUTF

readUTF