DataInputStream (Java Platform SE 8 )

java.lang.Object
- java.io.InputStream
- - java.io.FilterInputStream
  - - java.io.DataInputStream

All Implemented Interfaces:

Closeable， DataInput， AutoCloseable
```
public class DataInputStream
extends FilterInputStream
implements DataInput
```
数据输入流，让应用程序读取原始java数据类型从底层输入流中的一个独立于机器的方式。一个应用程序使用一个数据输出流来写数据，以后可以通过数据输入流读取。
输入流是不一定安全的多线程访问。线程安全是可选的，是在这个类中的方法的用户的责任。

从以下版本开始：

JDK1.0

另请参见：

DataOutputStream

Field Summary
- Fields inherited from class java.io.FilterInputStream
  in

构造方法摘要

构造方法
Constructor and Description
`DataInputStream(InputStream in)` 创建一个输入流InputStream使用指定的标。

方法摘要

所有方法静态方法接口方法具体的方法弃用的方法
Modifier and Type	Method and Description
`int`	`read(byte[] b)` 读取一定数量的字节从包含输入流并存入缓冲区阵列 `b`。
`int`	`read(byte[] b, int off, int len)` 读到 `len`从包含输入流读入字节数组数据字节。
`boolean`	`readBoolean()` 看到的 `DataInput`的 `readBoolean`方法一般合同。
`byte`	`readByte()` 看到的 `DataInput`的 `readByte`方法一般合同。
`char`	`readChar()` 看到的 `DataInput`的 `readChar`方法一般合同。
`double`	`readDouble()` 看到的 `DataInput`的 `readDouble`方法一般合同。
`float`	`readFloat()` 看到的 `DataInput`的 `readFloat`方法一般合同。
`void`	`readFully(byte[] b)` 看到的 `DataInput`的 `readFully`方法一般合同。
`void`	`readFully(byte[] b, int off, int len)` 看到的 `DataInput`的 `readFully`方法一般合同。
`int`	`readInt()` 看到的 `DataInput`的 `readInt`方法一般合同。
`String`	`readLine()` 过时的。此方法没有正确地将字节转换为字符。作为 JDK 1.1，阅读文本行的首选方式是通过`BufferedReader.readLine()`方法。程序使用的`DataInputStream`类的台词可以转换的形式替换代码中使用`BufferedReader`类： DataInputStream d = new DataInputStream(in); ： BufferedReader d = new BufferedReader(new InputStreamReader(in));
`long`	`readLong()` 看到的 `DataInput`的 `readLong`方法一般合同。
`short`	`readShort()` 看到的 `DataInput`的 `readShort`方法一般合同。
`int`	`readUnsignedByte()` 看到的 `DataInput`的 `readUnsignedByte`方法一般合同。
`int`	`readUnsignedShort()` 看到的 `DataInput`的 `readUnsignedShort`方法一般合同。
`String`	`readUTF()` 看到的 `DataInput`的 `readUTF`方法一般合同。
`static String`	`readUTF(DataInput in)` 从流 `in`一个Unicode字符串的编码格式在 modified UTF-8表示读取；这个字符串是作为一个 `String`返回。
`int`	`skipBytes(int n)` 看到的 `DataInput`的 `skipBytes`方法一般合同。

Methods inherited from class java.io.FilterInputStream
available, close, mark, markSupported, read, reset, skip

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - DataInputStream
```
public DataInputStream(InputStream in)
```
    创建一个输入流InputStream使用指定的标。
    
    参数
    
    in -指定输入流
- 方法详细信息
  - read
```
public final int read(byte[] b)
               throws IOException
```
    读取一定数量的字节从包含输入流并存入缓冲区阵列 b。实际读取的字节数作为一个整数返回。此方法块，直到输入数据可用，检测到文件结束，或抛出异常。
    如果b是空的，一个NullPointerException抛出。如果b长度为零，那么没有字节读0返回；否则，在试图读至少一个字节。如果没有可用的字节，因为流到达文件尾，价值-1返回；否则，至少有一个字节读入b。
    
    第一个字节存储在单元b[0]，未来一到b[1]，等等。读取的字节数，最多等于b长度。让k是实际读取的字节数目；这些字节将通过b[k-1]存储在元素b[0]，离开b[k] b[b.length-1]元素通过影响。
    
    的read(b)方法具有相同的效果：
    read(b, 0, b.length)
    重写：
    
    read 方法重写，继承类 FilterInputStream
    
    参数
    
    b -缓冲区中读取数据。
    
    结果
    
    读入缓冲的字节总数，或 -1如果没有更多的数据，因为已到达流的末尾。
    
    异常
    
    IOException -如果第一个字节不能读比其他文件的任何理由，流已经关闭，数据输入流不支持读取完毕后，或发生I/O错误。
    
    另请参见：
    
    FilterInputStream.in， InputStream.read(byte[], int, int)
  - read
```
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+k-1]存储在元素b[off]，离开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如果没有更多的数据，因为已到达流的末尾。
    
    异常
    
    如果是 null b NullPointerException。
    
    IndexOutOfBoundsException -如果 off是负的， len是负的，或 len大于 b.length - off
    
    IOException -如果第一个字节不能读比其他文件的任何理由，流已经关闭，数据输入流不支持读取完毕后，或发生I/O错误。
    
    另请参见：
    
    FilterInputStream.in， InputStream.read(byte[], int, int)
  - readFully
```
public final void readFully(byte[] b)
                     throws IOException
```
    看到的 DataInput的 readFully方法一般合同。
    此操作的字节从包含的输入流中读取。
    
    Specified by:
    
    readFully 接口 DataInput
    
    参数
    
    b -缓冲区中读取数据。
    
    异常
    
    EOFException如果输入流到达终点之前阅读所有字节。
    
    IOException -流已经关闭，包含输入流不支持读取完毕后，或发生I/O错误。
    
    另请参见：
    
    FilterInputStream.in
  - readFully
```
public final void readFully(byte[] b,
                            int off,
                            int len)
                     throws IOException
```
    看到的 DataInput的 readFully方法一般合同。
    此操作的字节从包含的输入流中读取。
    
    Specified by:
    
    readFully 接口 DataInput
    
    参数
    
    b -缓冲区中读取数据。
    
    off的起始偏移量的数据。
    
    len -字节数读。
    
    异常
    
    EOFException如果输入流到达终点之前阅读所有字节。
    
    IOException -流已经关闭，包含输入流不支持读取完毕后，或发生I/O错误。
    
    另请参见：
    
    FilterInputStream.in
  - skipBytes
```
public final int skipBytes(int n)
                    throws IOException
```
    看到的 DataInput的 skipBytes方法一般合同。
    此操作的字节从包含的输入流中读取。
    
    Specified by:
    
    skipBytes 接口 DataInput
    
    参数
    
    n -字节数被跳过。
    
    结果
    
    跳过的实际字节数。
    
    异常
    
    IOException如果包含输入流不支持查找，或流已经关闭，包含输入流不支持读取完毕后，或发生I/O错误。
  - readBoolean
```
public final boolean readBoolean()
                          throws IOException
```
    看到的 DataInput的 readBoolean方法一般合同。
    此操作的字节从包含的输入流中读取。
    
    Specified by:
    
    readBoolean 接口 DataInput
    
    结果
    
    boolean阅读的价值。
    
    异常
    
    EOFException如果输入流已结束。
    
    IOException -流已经关闭，包含输入流不支持读取完毕后，或发生I/O错误。
    
    另请参见：
    
    FilterInputStream.in
  - readByte
```
public final byte readByte()
                    throws IOException
```
    看到的 DataInput的 readByte方法一般合同。
    此操作的字节从包含的输入流中读取。
    
    Specified by:
    
    readByte 接口 DataInput
    
    结果
    
    这个输入流中的下一个字节是一个8位 byte签署。
    
    异常
    
    EOFException如果输入流已结束。
    
    IOException -流已经关闭，包含输入流不支持读取完毕后，或发生I/O错误。
    
    另请参见：
    
    FilterInputStream.in
  - readUnsignedByte
```
public final int readUnsignedByte()
                           throws IOException
```
    看到的 DataInput的 readUnsignedByte方法一般合同。
    此操作的字节从包含的输入流中读取。
    
    Specified by:
    
    readUnsignedByte 接口 DataInput
    
    结果
    
    这个输入流的下一个字节，解释为一个无符号的8位数字。
    
    异常
    
    EOFException如果输入流已结束。
    
    IOException -流已经关闭，包含输入流不支持读取完毕后，或发生I/O错误。
    
    另请参见：
    
    FilterInputStream.in
  - readShort
```
public final short readShort()
                      throws IOException
```
    看到的 DataInput的 readShort方法一般合同。
    此操作的字节从包含的输入流中读取。
    
    Specified by:
    
    readShort 接口 DataInput
    
    结果
    
    接下来的两个字节的输入流，解释为一个有符号的16位数字。
    
    异常
    
    EOFException -如果这个输入流读两字节之前到达终点。
    
    IOException -流已经关闭，包含输入流不支持读取完毕后，或发生I/O错误。
    
    另请参见：
    
    FilterInputStream.in
  - readUnsignedShort
```
public final int readUnsignedShort()
                            throws IOException
```
    看到的 DataInput的 readUnsignedShort方法一般合同。
    此操作的字节从包含的输入流中读取。
    
    Specified by:
    
    readUnsignedShort 接口 DataInput
    
    结果
    
    接下来的两个字节的输入流，解释为一个无符号的16位整数。
    
    异常
    
    EOFException -如果这个输入流读两字节之前到达终点。
    
    IOException -流已经关闭，包含输入流不支持读取完毕后，或发生I/O错误。
    
    另请参见：
    
    FilterInputStream.in
  - readChar
```
public final char readChar()
                    throws IOException
```
    看到的 DataInput的 readChar方法一般合同。
    此操作的字节从包含的输入流中读取。
    
    Specified by:
    
    readChar 接口 DataInput
    
    结果
    
    这个输入流中的下一个两字节解释为 char。
    
    异常
    
    EOFException -如果这个输入流读两字节之前到达终点。
    
    IOException -流已经关闭，包含输入流不支持读取完毕后，或发生I/O错误。
    
    另请参见：
    
    FilterInputStream.in
  - readInt
```
public final int readInt()
                  throws IOException
```
    看到的 DataInput的 readInt方法的一般合同。
    此操作的字节从包含的输入流中读取。
    
    Specified by:
    
    readInt 接口 DataInput
    
    结果
    
    这个输入流中的下一个四字节，解释为 int。
    
    异常
    
    EOFException -如果这个输入流读四个字节之前到达终点。
    
    IOException -流已经关闭，包含输入流不支持读取完毕后，或发生I/O错误。
    
    另请参见：
    
    FilterInputStream.in
  - readLong
```
public final long readLong()
                    throws IOException
```
    看到的 DataInput的 readLong方法一般合同。
    此操作的字节从包含的输入流中读取。
    
    Specified by:
    
    readLong 接口 DataInput
    
    结果
    
    这个输入流中的下一个八字节，解释为 long。
    
    异常
    
    EOFException -如果这个输入流读八个字节之前到达终点。
    
    IOException -流已经关闭，包含输入流不支持读取完毕后，或发生I/O错误。
    
    另请参见：
    
    FilterInputStream.in
  - readFloat
```
public final float readFloat()
                      throws IOException
```
    看到的 DataInput的 readFloat方法一般合同。
    此操作的字节从包含的输入流中读取。
    
    Specified by:
    
    readFloat 接口 DataInput
    
    结果
    
    这个输入流中的下一个四字节，解释为 float。
    
    异常
    
    EOFException -如果这个输入流读四个字节之前到达终点。
    
    IOException -流已经关闭，包含输入流不支持读取完毕后，或发生I/O错误。
    
    另请参见：
    
    readInt()， Float.intBitsToFloat(int)
  - readDouble
```
public final double readDouble()
                        throws IOException
```
    看到的 DataInput的 readDouble方法一般合同。
    此操作的字节从包含的输入流中读取。
    
    Specified by:
    
    readDouble 接口 DataInput
    
    结果
    
    这个输入流中的下一个八字节，解释为 double。
    
    异常
    
    EOFException -如果这个输入流读八个字节之前到达终点。
    
    IOException -流已经关闭，包含输入流不支持读取完毕后，或发生I/O错误。
    
    另请参见：
    
    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));
    看到的 DataInput的 readLine方法一般合同。
    此操作的字节从包含的输入流中读取。
    
    Specified by:
    
    readLine 接口 DataInput
    
    结果
    
    从这个输入流的下一行文本。
    
    异常
    
    IOException如果I/O错误发生。
    
    另请参见：
    
    BufferedReader.readLine()， FilterInputStream.in
  - readUTF
```
public final String readUTF()
                     throws IOException
```
    看到的 DataInput的 readUTF方法一般合同。
    此操作的字节从包含的输入流中读取。
    
    Specified by:
    
    readUTF 接口 DataInput
    
    结果
    
    Unicode字符串。
    
    异常
    
    EOFException如果输入流到达终点之前阅读所有字节。
    
    IOException -流已经关闭，包含输入流不支持读取完毕后，或发生I/O错误。
    
    UTFDataFormatException如果字节没有表示一个有效的修改一个字符串编码UTF-8。
    
    另请参见：
    
    readUTF(java.io.DataInput)
  - readUTF
```
public static final String readUTF(DataInput in)
                            throws IOException
```
    从流 in一个Unicode字符串的编码格式在 modified UTF-8表示读取；这个字符串是作为一个 String返回。UTF-8的细节是完全一样的 DataInput的 readUTF方法。
    
    参数
    
    in -数据输入流。
    
    结果
    
    Unicode字符串。
    
    异常
    
    EOFException如果输入流到达终点之前的所有字节。
    
    IOException -流已经关闭，包含输入流不支持读取完毕后，或发生I/O错误。
    
    UTFDataFormatException如果字节没有表示一个有效的修改UTF-8 Unicode字符串编码。
    
    另请参见：
    
    readUnsignedShort()

Submit a bug or feature
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, 2014, Oracle and/or its affiliates. All rights reserved.

Class DataInputStream

Field Summary

Fields inherited from class java.io.FilterInputStream

构造方法摘要

方法摘要

Methods inherited from class java.io.FilterInputStream

Methods inherited from class java.lang.Object

Constructor Detail

DataInputStream

方法详细信息

read

read

readFully

readFully

skipBytes

readBoolean

readByte

readUnsignedByte

readShort

readUnsignedShort

readChar

readInt

readLong

readFloat

readDouble

readLine

readUTF

readUTF