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数据类型。应用程序使用数据输出流来写入稍后可以被数据输入流读取的数据。
DataInputStream对于多线程访问来说不一定是安全的。线程安全是可选的，是本课程中用户的责任。

从以下版本开始：

JDK1.0

另请参见：

DataOutputStream

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

构造方法摘要

构造方法
Constructor and Description
`DataInputStream(InputStream in)` 创建使用指定的底层InputStream的DataInputStream。

方法摘要

所有方法静态方法接口方法具体的方法弃用的方法
Modifier and Type	Method and Description
`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`的一般合同。
`String`	`readLine()` 已弃用此方法无法将字节正确转换为字符。从JDK 1.1开始，读取文本行的`BufferedReader.readLine()`方法是通过`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`的一般合同。
`String`	`readUTF()` 见 `readUTF`法 `DataInput`的一般合同。
`static String`	`readUTF(DataInput in)` 从流`in`读取以modified UTF-8格式编码的Unicode字符串的表示; 这个字符串然后作为`String`返回。
`int`	`skipBytes(int n)` 见 `skipBytes`法 `DataInput`的一般合同。

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

- 构造方法详细信息
  - DataInputStream
```
public DataInputStream(InputStream in)
```
    创建使用指定的底层InputStream的DataInputStream。
    
    参数
    
    in - 指定的输入流
- 方法详细信息
  - read
```
public final int read(byte[] b)
               throws IOException
```
    从包含的输入流中读取一些字节数，并将它们存储到缓冲区数组b 。实际读取的字节数作为整数返回。该方法阻塞直到输入数据可用，检测到文件结束或抛出异常。
    如果b为null，则抛出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 - 如果由于文件结尾以外的任何原因无法读取第一个字节，则流已关闭，底层输入流不支持关闭后读取，或者发生另一个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则返回值-1 ; 否则，读取至少一个字节并存储到b 。
    
    读取的第一个字节存储在元素b[off] ，下一个字节存入b[off+1] ，依此类推。读取的字节数最多等于len 。令k为实际读取的字节数; 这些字节将被存储在元素b[off]通过b[off+ ķ -1] ，留下元件b[off+ ķ ]通过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 - 如果由于文件结尾以外的任何原因无法读取第一个字节，则流已关闭，底层输入流不支持关闭后读取，或者发生另一个I / O错误。
    
    另请参见：
    
    FilterInputStream.in ， InputStream.read(byte[], int, int)
  - readFully
```
public final void readFully(byte[] b)
                     throws IOException
```
    见readFully方法DataInput的一般合同。
    从所包含的输入流中读取此操作的字节数。
    
    Specified by:
    
    readFully在界面 DataInput
    
    参数
    
    b - 读取数据的缓冲区。
    
    异常
    
    EOFException - 如果此输入流在读取所有字节之前到达结束。
    
    IOException - 流已关闭，包含的输入流不支持关闭后读取，或发生另一个I / O错误。
    
    另请参见：
    
    FilterInputStream.in
  - readFully
```
public final void readFully(byte[] b,
                            int off,
                            int len)
                     throws IOException
```
    见的总承包readFully的方法DataInput 。
    从所包含的输入流中读取此操作的字节数。
    
    Specified by:
    
    readFully在界面 DataInput
    
    参数
    
    b - 读取数据的缓冲区。
    
    off - 数据的起始偏移量。
    
    len - 要读取的字节数。
    
    异常
    
    EOFException - 如果此输入流在读取所有字节之前到达结束。
    
    IOException - 流已关闭，包含的输入流在关闭后不支持读取，或发生另一个I / O错误。
    
    另请参见：
    
    FilterInputStream.in
  - skipBytes
```
public final int skipBytes(int n)
                    throws IOException
```
    见skipBytes方法DataInput的一般合同。
    从所包含的输入流中读取此操作的字节数。
    
    Specified by:
    
    skipBytes在接口 DataInput
    
    参数
    
    n - 要跳过的字节数。
    
    结果
    
    实际跳过的字节数。
    
    异常
    
    IOException - 如果包含的输入流不支持查询，或流已关闭，并且所包含的输入流不支持关闭后读取，或者发生另一个I / O错误。
  - readBoolean
```
public final boolean readBoolean()
                          throws IOException
```
    见readBoolean方法DataInput的一般合同。
    从所包含的输入流中读取此操作的字节数。
    
    Specified by:
    
    readBoolean在接口 DataInput
    
    结果
    
    boolean值读取。
    
    异常
    
    EOFException - 如果此输入流已到达结束。
    
    IOException - 流已关闭，包含的输入流不支持关闭后读取，或发生另一个I / O错误。
    
    另请参见：
    
    FilterInputStream.in
  - readByte
```
public final byte readByte()
                    throws IOException
```
    见readByte方法DataInput的一般合同。
    从所包含的输入流中读取此操作的字节数。
    
    Specified by:
    
    readByte中的 DataInput
    
    结果
    
    该输入流的下一个字节作为带符号的8位 byte 。
    
    异常
    
    EOFException - 如果此输入流已到达结束。
    
    IOException - 流已关闭，包含的输入流不支持关闭后读取，或发生另一个I / O错误。
    
    另请参见：
    
    FilterInputStream.in
  - readUnsignedByte
```
public final int readUnsignedByte()
                           throws IOException
```
    见的总承包readUnsignedByte的方法DataInput 。
    从所包含的输入流中读取此操作的字节数。
    
    Specified by:
    
    readUnsignedByte在界面 DataInput
    
    结果
    
    该输入流的下一个字节被解释为无符号的8位数字。
    
    异常
    
    EOFException - 如果此输入流已经到达结束。
    
    IOException - 流已关闭，包含的输入流不支持关闭后读取，或发生另一个I / O错误。
    
    另请参见：
    
    FilterInputStream.in
  - readShort
```
public final short readShort()
                      throws IOException
```
    见readShort方法DataInput的一般合同。
    从所包含的输入流中读取此操作的字节数。
    
    Specified by:
    
    readShort在接口 DataInput
    
    结果
    
    该输入流的下两个字节，被解释为一个有符号的16位数字。
    
    异常
    
    EOFException - 如果此输入流在读取两个字节之前到达结束。
    
    IOException - 流已关闭，包含的输入流不支持关闭后读取，或发生另一个I / O错误。
    
    另请参见：
    
    FilterInputStream.in
  - readUnsignedShort
```
public final int readUnsignedShort()
                            throws IOException
```
    见的总承包readUnsignedShort的方法DataInput 。
    从所包含的输入流中读取此操作的字节数。
    
    Specified by:
    
    readUnsignedShort在接口 DataInput
    
    结果
    
    该输入流的下两个字节被解释为无符号16位整数。
    
    异常
    
    EOFException - 如果此输入流在读取两个字节之前到达结束。
    
    IOException - 流已关闭，包含的输入流在关闭后不支持读取，或发生另一个I / O错误。
    
    另请参见：
    
    FilterInputStream.in
  - readChar
```
public final char readChar()
                    throws IOException
```
    见的总承包readChar的方法DataInput 。
    从所包含的输入流中读取此操作的字节数。
    
    Specified by:
    
    readChar中的 DataInput
    
    结果
    
    该输入流的下两个字节，解释为 char 。
    
    异常
    
    EOFException - 如果此输入流在读取两个字节之前到达结束。
    
    IOException - 流已关闭，包含的输入流在关闭后不支持读取，或发生另一个I / O错误。
    
    另请参见：
    
    FilterInputStream.in
  - readInt
```
public final int readInt()
                  throws IOException
```
    见的总承包readInt的方法DataInput 。
    从所包含的输入流中读取此操作的字节数。
    
    Specified by:
    
    readInt中的 DataInput
    
    结果
    
    该输入流的接下来的四个字节被解释为 int 。
    
    异常
    
    EOFException - 如果此输入流在读取四个字节之前到达结束。
    
    IOException - 流已关闭，包含的输入流在关闭后不支持读取，或发生另一个I / O错误。
    
    另请参见：
    
    FilterInputStream.in
  - readLong
```
public final long readLong()
                    throws IOException
```
    见readLong法DataInput的一般合同。
    从所包含的输入流中读取此操作的字节数。
    
    Specified by:
    
    readLong在接口 DataInput
    
    结果
    
    该输入流的接下来的八个字节，解释为 long 。
    
    异常
    
    EOFException - 如果此输入流在读取八个字节之前到达结束。
    
    IOException - 流已关闭，包含的输入流不支持关闭后读取，或发生另一个I / O错误。
    
    另请参见：
    
    FilterInputStream.in
  - readFloat
```
public final float readFloat()
                      throws IOException
```
    见readFloat方法DataInput的一般合同。
    从所包含的输入流中读取此操作的字节数。
    
    Specified by:
    
    readFloat在界面 DataInput
    
    结果
    
    该输入流的接下来的四个字节被解释为 float 。
    
    异常
    
    EOFException - 如果此输入流在读取四个字节之前到达结束。
    
    IOException - 流已关闭，包含的输入流不支持关闭后读取，或发生另一个I / O错误。
    
    另请参见：
    
    readInt() ， Float.intBitsToFloat(int)
  - readDouble
```
public final double readDouble()
                        throws IOException
```
    见readDouble法DataInput的一般合同。
    从所包含的输入流中读取此操作的字节数。
    
    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()方法是通过BufferedReader.readLine()方法。使用DataInputStream类读取行的程序可以转换为使用BufferedReader类替换以下形式的代码：
    DataInputStream d = new DataInputStream(in);
    与：
    BufferedReader d = new BufferedReader(new InputStreamReader(in));
    见的总承包readLine的方法DataInput 。
    从所包含的输入流中读取此操作的字节数。
    
    Specified by:
    
    readLine在界面 DataInput
    
    结果
    
    来自此输入流的下一行文本。
    
    异常
    
    IOException - 如果发生I / O错误。
    
    另请参见：
    
    BufferedReader.readLine() ， FilterInputStream.in
  - readUTF
```
public final String readUTF()
                     throws IOException
```
    见readUTF法DataInput的一般合同。
    从所包含的输入流中读取此操作的字节数。
    
    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方法DataInput 。
    
    参数
    
    in - 数据输入流。
    
    结果
    
    一个Unicode字符串。
    
    异常
    
    EOFException - 如果输入流在所有字节之前到达结束。
    
    IOException - 流已关闭，包含的输入流不支持关闭后读取，或者发生另一个I / O错误。
    
    UTFDataFormatException - 如果字节不表示Unicode字符串的有效修改的UTF-8编码。
    
    另请参见：
    
    readUnsignedShort()

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

构造方法详细信息

DataInputStream

方法详细信息

read

read

readFully

readFully

skipBytes

readBoolean

readByte

readUnsignedByte

readShort

readUnsignedShort

readChar

readInt

readLong

readFloat

readDouble

readLine

readUTF

readUTF