ImageInputStream (Java Platform SE 8 )

All Superinterfaces:

AutoCloseable ， Closeable ， DataInput

All Known Subinterfaces:

ImageOutputStream

所有已知实现类：

FileCacheImageInputStream ， FileCacheImageOutputStream ， FileImageInputStream ， FileImageOutputStream ， ImageInputStreamImpl ， ImageOutputStreamImpl ， MemoryCacheImageInputStream ， MemoryCacheImageOutputStream
```
public interface ImageInputStream
extends DataInput, Closeable
```
的可查找输入流接口供ImageReader秒。诸如InputStream和File之类的各种输入源以及未来的快速I / O源可以被该接口的适当实现“包裹”，以供Image I / O API使用。

另请参见：

ImageInputStreamImpl ， FileImageInputStream ， FileCacheImageInputStream ， MemoryCacheImageInputStream

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`void`	`close()` 关闭流。
`void`	`flush()` 在当前流位置之前丢弃流的初始位置。
`void`	`flushBefore(long pos)` 在指示的位置之前丢弃流的初始部分。
`int`	`getBitOffset()` 返回当前的位偏移量，为0到7之间的整数，包括0和7。
`ByteOrder`	`getByteOrder()` 作为 `java.nio.ByteOrder`枚举的实例，返回从该流读取数据值的字节顺序。
`long`	`getFlushedPosition()` 返回可以执行搜索的流中的最早位置。
`long`	`getStreamPosition()` 返回流的当前字节位置。
`boolean`	`isCached()` 如果这 `ImageInputStream`缓存数据本身以返回 `true` ，则返回。
`boolean`	`isCachedFile()` 如果这个 `ImageInputStream`缓存数据本身以便允许向后查询，则返回 `true` ，并且高速缓存保存在临时文件中。
`boolean`	`isCachedMemory()` 如果 `ImageInputStream`缓存数据本身以返回 `true` ，以允许向后搜索，并且高速缓存保存在主内存中。
`long`	`length()` 如果已知，返回流的总长度。
`void`	`mark()` 在流中标记要通过后续呼叫返回到 `reset` 。
`int`	`read()` 从流中读取一个字节，并将其作为0到255之间的整数返回。
`int`	`read(byte[] b)` 从流中读取最多 `b.length`个字节，并将其存储在从索引0开始的 `b`中。
`int`	`read(byte[] b, int off, int len)` 读取到 `len`从流字节，并将其存储到 `b`开始于索引 `off` 。
`int`	`readBit()` 从流中读取一个位，并将其作为 `int`返回，值为 `0`或 `1` 。
`long`	`readBits(int numBits)` 从流中读取一个bitstring，并将其作为 `long`返回，第一位读取成为输出的最高有效位。
`boolean`	`readBoolean()` 从流中读取一个字节，如果非零， `false`值为 `true`如果为零，则返回 `boolean` 。
`byte`	`readByte()` 从流中读取一个字节，并将其作为 `byte`值返回。
`void`	`readBytes(IIOByteBuffer buf, int len)` 从流中读取最多 `len`个字节，并修改提供的 `IIOByteBuffer`以指示可能找到数据的字节数组，偏移量和长度。
`char`	`readChar()` 相当于 `readUnsignedShort` ，除了使用 `char`数据类型返回结果。
`double`	`readDouble()` 从流中读取8个字节，（在概念上）根据当前字节顺序连接它们，并将结果作为 `double`返回。
`float`	`readFloat()` 从流中读取4个字节，（在概念上）根据当前字节顺序连接它们，并将结果作为 `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`从根据当前字节顺序的流整数（带符号的32位整数），并将其存储到 `i`开始于索引 `off` 。
`void`	`readFully(long[] l, int off, int len)` 读取 `len`从根据当前字节顺序的流long（有符号的64位整数），并将其存储到 `l`开始于索引 `off` 。
`void`	`readFully(short[] s, int off, int len)` 读取 `len`从根据当前字节顺序的流短裤（带符号的16位整数），并将其存储到 `s`开始于索引 `off` 。
`int`	`readInt()` 从流中读取4个字节，（在概念上）根据当前字节顺序连接它们，并以 `int`返回结果。
`String`	`readLine()` 从输入流读取下一行文本。
`long`	`readLong()` 从流中读取8个字节，（在概念上）根据当前字节顺序连接它们，并将结果作为 `long`返回。
`short`	`readShort()` 从流中读取两个字节，（在概念上）根据当前字节顺序连接它们，并将结果作为 `short`值返回。
`int`	`readUnsignedByte()` 从流读取一个字节，（在概念上）将其转换为int，使用 `0xff`屏蔽它，以便剥离任何符号扩展位，并将其作为 `byte`值返回。
`long`	`readUnsignedInt()` 从流中读取4个字节，并且（在概念上）根据当前字节顺序连接它们，将结果转换为长时间，使用 `0xffffffffL`屏蔽它，以便剥离任何符号扩展位，并将结果作为无符号 `long`值。
`int`	`readUnsignedShort()` 从流中读取两个字节，并且（在概念上）根据当前字节顺序连接它们，将结果值转换为int，使用 `int`对其进行 `0xffff` ，以剥离任何符号扩展名，并将结果作为无符号返回 `int`价值。
`String`	`readUTF()` 读取已使用 modified UTF-8格式编码的字符串。
`void`	`reset()` 在最近不匹配的呼叫到 `mark`的时候，返回到前一个位置的流指针，包括位偏移量。
`void`	`seek(long pos)` 将当前流位置设置为所需位置。
`void`	`setBitOffset(int bitOffset)` 将位偏移设置为0到7之间的整数，包括0和7。
`void`	`setByteOrder(ByteOrder byteOrder)` 设置用于将来从该流读取数据值的字节顺序。
`int`	`skipBytes(int n)` 将流位置向前移动给定数量的字节。
`long`	`skipBytes(long n)` 将流位置向前移动给定数量的字节。

- 方法详细信息
  - setByteOrder
```
void setByteOrder(ByteOrder byteOrder)
```
    设置用于将来从该流读取数据值的字节顺序。例如，如果以4字节整数读取，字节“0x01 0x02 0x03 0x04”的序列将以反向字节顺序使用网络字节顺序，值为“0x04030201”。
    枚举类java.nio.ByteOrder用于指定字节顺序。 ByteOrder.BIG_ENDIAN的值指定了所谓的大端或网元字节顺序，其中高位字节首先出现。摩托罗拉和Sparc处理器以这种格式存储数据，而英特尔处理器则按照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)
  - read
```
int read()
  throws IOException
```
    从流读取单个字节，并将其作为0到255之间的整数返回。如果到达流的结尾，则返回-1。
    在发生读取之前，流内的位偏移被重置为零。
    
    结果
    
    来自流的字节值，作为int，或-1表示EOF。
    
    异常
    
    IOException - 如果发生I / O错误。
  - read
```
int read(byte[] b)
  throws IOException
```
    从流中读取最多b.length个字节，并将它们存储在从索引0开始的b中。返回读取的字节数。如果没有字节可以读取，因为已经到达流的结尾，则返回-1。
    在发生读取之前，流内的位偏移被重置为零。
    
    参数
    
    b - 要写入的字节数组。
    
    结果
    
    实际读取的字节数，或 -1表示EOF。
    
    异常
    
    NullPointerException - 如果 b是 null 。
    
    IOException - 如果发生I / O错误。
  - read
```
int read(byte[] b,
         int off,
         int len)
  throws IOException
```
    读取到len从流字节，并将其存储到b开始于索引off 。返回读取的字节数。如果没有字节可以读取，因为已经到达流的末尾，则返回-1 。
    在发生读取之前，流内的位偏移被重置为零。
    
    参数
    
    b - 要写入的字节数组。
    
    off - 起始位置在 b内写。
    
    len - 要阅读的最大数量为 byte 。
    
    结果
    
    实际读取的字节数，或 -1表示EOF。
    
    异常
    
    NullPointerException - 如果 b是 null 。
    
    IndexOutOfBoundsException - 如果 off为负， len ，否则为 off + len ，否则为 b.length 。
    
    IOException - 如果发生I / O错误。
  - readBytes
```
void readBytes(IIOByteBuffer buf,
               int len)
        throws IOException
```
    从流中读取最多len个字节，并修改提供的IIOByteBuffer以指示可能找到数据的字节数组，偏移量和长度。来电者不应该尝试修改在IIOByteBuffer找到的数据。
    在发生读取之前，流内的位偏移被重置为零。
    
    参数
    
    buf - 要修改的IIOByteBuffer对象。
    
    len - 要阅读的最大数量 byte 。
    
    异常
    
    IndexOutOfBoundsException - 如果 len是否定的。
    
    NullPointerException - 如果 buf是 null 。
    
    IOException - 如果发生I / O错误。
  - readBoolean
```
boolean readBoolean()
             throws IOException
```
    从流中读取一个字节，如果值为零，则返回boolean值为true （ false 。
    在发生读取之前，流内的位偏移被重置为零。
    
    Specified by:
    
    readBoolean在接口 DataInput
    
    结果
    
    来自流的布尔值。
    
    异常
    
    EOFException - 如果达到流的结尾。
    
    IOException - 如果发生I / O错误。
  - readByte
```
byte readByte()
       throws IOException
```
    从流中读取一个字节，并以byte值返回。之间的字节值0x00和0x7f表示之间的整数值0和127 。 0x80和0xff之间的值代表从-128到/1 。
    在发生读取之前，流内的位偏移被重置为零。
    
    Specified by:
    
    readByte在界面 DataInput
    
    结果
    
    来自流的有符号字节值。
    
    异常
    
    EOFException - 如果达到流的结尾。
    
    IOException - 如果发生I / O错误。
  - readUnsignedByte
```
int readUnsignedByte()
              throws IOException
```
    从流读取一个字节，（在概念上）将其转换为int，使用0xff进行掩码，以剥离任何符号扩展位，并将其作为byte值返回。
    因此， 0x00和0x7f之间的字节值简单地作为0和127之间的整数值返回。 0x80和0xff之间的值通常代表负值byte ，将映射到128和255之间的正整数。
    
    在发生读取之前，流内的位偏移被重置为零。
    
    Specified by:
    
    readUnsignedByte在接口 DataInput
    
    结果
    
    来自流的无符号字节值。
    
    异常
    
    EOFException - 如果达到流的结尾。
    
    IOException - 如果发生I / O错误。
  - readShort
```
short readShort()
         throws IOException
```
    从流中读取两个字节，（在概念上）根据当前字节顺序连接它们，并以short值返回结果。
    在发生读取之前，流内的位偏移被重置为零。
    
    Specified by:
    
    readShort在界面 DataInput
    
    结果
    
    从流中签名的短值。
    
    异常
    
    EOFException - 如果流在读取所有字节之前到达结束。
    
    IOException - 如果发生I / O错误。
    
    另请参见：
    
    getByteOrder()
  - readUnsignedShort
```
int readUnsignedShort()
               throws IOException
```
    中读取两个字节从该流，并根据当前字节顺序（概念上）将其连接，将得到的值转换为int ，口罩它0xffff为了去掉所有符号扩展位，并返回结果以无符号int价值。
    在发生读取之前，流内的位偏移被重置为零。
    
    Specified by:
    
    readUnsignedShort在界面 DataInput
    
    结果
    
    来自流的无符号短值，作为int。
    
    异常
    
    EOFException - 如果流在读取所有字节之前到达结束。
    
    IOException - 如果发生I / O错误。
    
    另请参见：
    
    getByteOrder()
  - readChar
```
char readChar()
       throws IOException
```
    相当于readUnsignedShort ，除了使用char数据类型返回结果。
    在发生读取之前，流内的位偏移被重置为零。
    
    Specified by:
    
    readChar在界面 DataInput
    
    结果
    
    来自流的无符号字符值。
    
    异常
    
    EOFException - 如果流在读取所有字节之前到达结束。
    
    IOException - 如果发生I / O错误。
    
    另请参见：
    
    readUnsignedShort()
  - readInt
```
int readInt()
     throws IOException
```
    从流中读取4个字节，（在概念上）根据当前字节顺序连接它们，并以int返回结果。
    流内的位偏移被忽略，并被视为零。
    
    Specified by:
    
    readInt在界面 DataInput
    
    结果
    
    来自流的已签名的int值。
    
    异常
    
    EOFException - 如果流在读取所有字节之前到达结束。
    
    IOException - 如果发生I / O错误。
    
    另请参见：
    
    getByteOrder()
  - readUnsignedInt
```
long readUnsignedInt()
              throws IOException
```
    从流中读取4个字节，（从概念上讲）根据当前字节顺序连接它们，将结果转换为长时间，使用0xffffffffL进行掩码，以剥离任何符号扩展位，并将结果返回为无符号long值。
    在发生读取之前，流内的位偏移被重置为零。
    
    结果
    
    来自流的无符号int值，长久。
    
    异常
    
    EOFException - 如果流在读取所有字节之前到达结束。
    
    IOException - 如果发生I / O错误。
    
    另请参见：
    
    getByteOrder()
  - readLong
```
long readLong()
       throws IOException
```
    从流中读取8个字节，（在概念上）根据当前字节顺序连接它们，并将结果作为long返回。
    在发生读取之前，流内的位偏移被重置为零。
    
    Specified by:
    
    readLong在界面 DataInput
    
    结果
    
    从流中签名的长值。
    
    异常
    
    EOFException - 如果流在读取所有字节之前到达结束。
    
    IOException - 如果发生I / O错误。
    
    另请参见：
    
    getByteOrder()
  - readFloat
```
float readFloat()
         throws IOException
```
    从流中读取4个字节，（在概念上）根据当前字节顺序连接它们，并将结果作为float返回。
    在发生读取之前，流内的位偏移被重置为零。
    
    Specified by:
    
    readFloat在界面 DataInput
    
    结果
    
    来自流的浮点值。
    
    异常
    
    EOFException - 如果流在读取所有字节之前到达结束。
    
    IOException - 如果发生I / O错误。
    
    另请参见：
    
    getByteOrder()
  - readDouble
```
double readDouble()
           throws IOException
```
    从流中读取8个字节，（在概念上）根据当前字节顺序连接它们，并将结果作为double返回。
    在发生读取之前，流内的位偏移被重置为零。
    
    Specified by:
    
    readDouble在界面 DataInput
    
    结果
    
    来自流的双重值。
    
    异常
    
    EOFException - 如果流在读取所有字节之前到达结束。
    
    IOException - 如果发生I / O错误。
    
    另请参见：
    
    getByteOrder()
  - readLine
```
String readLine()
         throws IOException
```
    从输入流读取下一行文本。它读取连续字节，将每个字节分别转换为字符，直到遇到行终止符或文件结尾; 读取的字符然后作为String返回。请注意，由于此方法处理字节，它不支持输入完整的Unicode字符集。
    如果在甚至可以读取一个字节之前遇到文件结束，则返回null 。否则，每个所读取字节被转换为类型char由零扩展。如果遇到'\n' '\n'，则会被丢弃，读取停止。如果遇到'\r' '\r'，则会被丢弃，如果以下字节转换为字符'\n' ，那么也将被丢弃; 阅读然后停止。如果在遇到任何一个字符'\n'和'\r'之前遇到文件结尾，则读取停止。一旦阅读停止，将返回一个String ，其中包含读取并且不被丢弃的所有字符。请注意，此字符串中的每个字符的值都小于\u0100 ，即(char)256 。
    
    在发生读取之前，流内的位偏移被重置为零。
    
    Specified by:
    
    readLine在界面 DataInput
    
    结果
    
    一个包含流中文本行的字符串。
    
    异常
    
    IOException - 如果发生I / O错误。
  - readUTF
```
String readUTF()
        throws IOException
```
    读取已使用modified UTF-8格式编码的字符串。 readUTF的一般合同是它读取以修改的UTF-8格式编码的Unicode字符串的表示; 这个字符串然后作为一个String返回。
    首先，使用网络字节顺序（不考虑当前字节顺序设置），以readUnsignedShort方法的方式读取和使用两个字节构造无符号16位整数。该整数值称为UTF长度 ，并指定要读取的其他字节数。然后将这些字节通过组合考虑来转换为字符。每组的长度根据组的第一个字节的值计算。组之后的字节（如果有的话）是下一组的第一个字节。
    
    如果一个组的第一个字节与位模式0xxxxxxx （其中x表示“可能是0或1 ”） 1 ，则该组由该字节组成。该字节是零扩展形成一个字符。
    
    如果一组的第一个字节与位模式110xxxxx匹配，那么该组由该字节a和第二个字节b 。如果没有字节b （因为字节a是要读取的最后一个字节），或者如果字节b与位模式10xxxxxx不匹配，则抛出UTFDataFormatException 。否则，该组将转换为字符：
```
   (char)(((a& 0x1F) << 6) | (b & 0x3F))  
```
    如果一组的第一个字节与位模式1110xxxx匹配，则该组由该字节a和另外两个字节b和c 。如果没有字节c （因为字节a是要读取的最后两个字节之一），或者字节b或字节c与位模式10xxxxxx不匹配，则抛出UTFDataFormatException 。否则，该组将转换为字符：
```
   (char)(((a & 0x0F) << 12) | ((b & 0x3F) << 6) | (c & 0x3F))  
```
    如果组的第一个字节与模式1111xxxx或模式10xxxxxx ，则抛出UTFDataFormatException 。
    如果在整个过程中的任何时间遇到文件结尾，则抛出java.io.EOFException 。
    
    通过此过程将每个组转换为一个字符后，以与输入流中读取相应组相同的顺序收集String ，形成一个返回的String 。
    
    当前字节顺序设置被忽略。
    
    在发生读取之前，流内的位偏移被重置为零。
    
    注意：此方法不应用于执行使用标准UTF-8的图像格式，因为此处使用的修改后的UTF-8与标准UTF-8不兼容。
    Specified by:
    
    readUTF在界面 DataInput
    
    结果
    
    从流中读取的字符串。
    
    异常
    
    EOFException - 如果此流在读取所有字节之前到达结束。
    
    UTFDataFormatException - 如果字节不表示字符串的有效修改的UTF-8编码。
    
    IOException - 如果发生I / O错误。
  - readFully
```
void readFully(byte[] b,
               int off,
               int len)
        throws IOException
```
    从流中读取len字节，并将它们存储在b从索引off开始。如果达到流的末尾，将抛出一个java.io.EOFException 。
    在发生读取之前，流内的位偏移被重置为零。
    
    Specified by:
    
    readFully在界面 DataInput
    
    参数
    
    b - 要写入的字节数组。
    
    off - 起始位置在 b内写。
    
    len - 要阅读的最大数量为 byte 。
    
    异常
    
    IndexOutOfBoundsException - 如果 off为负数， len为负数，或 off + len大于 b.length 。
    
    NullPointerException - 如果 b是 null 。
    
    EOFException - 如果流在读取所有字节之前到达结束。
    
    IOException - 如果发生I / O错误。
  - readFully
```
void readFully(byte[] b)
        throws IOException
```
    读取b.length从流字节，并将其存储到b开始于索引0 。如果达到流的末尾，将抛出一个java.io.EOFException 。
    在发生读取之前，流内的位偏移被重置为零。
    
    Specified by:
    
    readFully在界面 DataInput
    
    参数
    
    b -的阵列 byte秒。
    
    异常
    
    NullPointerException - 如果 b是 null 。
    
    EOFException - 如果流在读取所有字节之前到达结束。
    
    IOException - 如果发生I / O错误。
  - readFully
```
void readFully(short[] s,
               int off,
               int len)
        throws IOException
```
    读取len从根据当前字节顺序的流短裤（带符号的16位整数），并将其存储到s开始于索引off 。如果达到流的末尾，将抛出一个java.io.EOFException 。
    在发生读取之前，流内的位偏移被重置为零。
    
    参数
    
    s - 要写入的短裤阵列。
    
    off - 起始位置在 s内写。
    
    len - 要阅读的最大数量为 short 。
    
    异常
    
    IndexOutOfBoundsException - 如果 off为负数，则 len为负数，或 off + len大于 s.length 。
    
    NullPointerException - 如果 s是 null 。
    
    EOFException - 如果流在读取所有字节之前到达结束。
    
    IOException - 如果发生I / O错误。
  - readFully
```
void readFully(char[] c,
               int off,
               int len)
        throws IOException
```
    读取len从根据当前字节顺序的流字符（无符号的16位整数），并将其存储到c开始于索引off 。如果到达流的末尾，将抛出一个java.io.EOFException 。
    在发生读取之前，流内的位偏移被重置为零。
    
    参数
    
    c - 要写入的字符数组。
    
    off - 起始位置在 c内写。
    
    len - 要阅读的最大数量为 char 。
    
    异常
    
    IndexOutOfBoundsException - 如果 off为负数， len ，否则为 off + len ，或 off + len大于 c.length 。
    
    NullPointerException - 如果 c是 null 。
    
    EOFException - 如果流在读取所有字节之前到达结束。
    
    IOException - 如果发生I / O错误。
  - readFully
```
void readFully(int[] i,
               int off,
               int len)
        throws IOException
```
    读取len从根据当前字节顺序的流整数（带符号的32位整数），并将其存储到i开始于索引off 。如果达到流的末尾，将抛出一个java.io.EOFException 。
    在发生读取之前，流内的位偏移被重置为零。
    
    参数
    
    i - 要写入的int数组。
    
    off - 起始位置在 i内写。
    
    len - 要阅读的最大数量为 int 。
    
    异常
    
    IndexOutOfBoundsException - 如果 off是负数，则 len为负数，或 off + len大于 i.length 。
    
    NullPointerException - 如果 i是 null 。
    
    EOFException - 如果流在读完所有字节之前到达结束。
    
    IOException - 如果发生I / O错误。
  - readFully
```
void readFully(long[] l,
               int off,
               int len)
        throws IOException
```
    读取len从根据当前字节顺序的流long（有符号的64位整数），并将其存储到l开始于索引off 。如果到达流的末尾，将抛出一个java.io.EOFException 。
    在发生读取之前，流内的位偏移被重置为零。
    
    参数
    
    l - 要写入的数组。
    
    off - 起始位置在 l内写。
    
    len - 要阅读的最大数量为 long 。
    
    异常
    
    IndexOutOfBoundsException - 如果 off为负数，则 len为负数，或 off + len大于 l.length 。
    
    NullPointerException - 如果 l是 null 。
    
    EOFException - 如果流在读取所有字节之前到达结束。
    
    IOException - 如果发生I / O错误。
  - readFully
```
void readFully(float[] f,
               int off,
               int len)
        throws IOException
```
    读取len根据当前字节顺序从流浮标（32位IEEE单精度浮点值），并且将它们存储到f开始于索引off 。如果达到流的末尾，将抛出一个java.io.EOFException 。
    在发生读取之前，流内的位偏移被重置为零。
    
    参数
    
    f - 要写入的浮点数组。
    
    off - 起始位置在 f内写。
    
    len - 要阅读的最大数量为 float 。
    
    异常
    
    IndexOutOfBoundsException - 如果 off为负， len ，否则为 off + len ，或 off + len大于 f.length 。
    
    NullPointerException - 如果 f是 null 。
    
    EOFException - 如果流在读取所有字节之前到达结束。
    
    IOException - 如果发生I / O错误。
  - readFully
```
void readFully(double[] d,
               int off,
               int len)
        throws IOException
```
    读取len根据当前字节顺序从流双打（64位IEEE双精度浮点值），并且将它们存储到d开始于索引off 。如果达到流的末尾，将抛出java.io.EOFException 。
    在发生读取之前，流内的位偏移被重置为零。
    
    参数
    
    d - 要写入的双精度数组。
    
    off - 起始位置在 d内写。
    
    len - 要阅读的最大数量为 double 。
    
    异常
    
    IndexOutOfBoundsException - 如果 off为负数，则 len为负数，或 off + len大于 d.length 。
    
    NullPointerException - 如果 d是 null 。
    
    EOFException - 如果流在读取所有字节之前到达结束。
    
    IOException - 如果发生I / O错误。
  - getStreamPosition
```
long getStreamPosition()
                throws IOException
```
    返回流的当前字节位置。下一次读取将从此偏移开始。
    
    结果
    
    一个长的包含流的位置。
    
    异常
    
    IOException - 如果发生I / O错误。
  - getBitOffset
```
int getBitOffset()
          throws IOException
```
    返回当前的位偏移量，为0到7之间的整数，包括0和7。通过调用readBits方法readBits更新位偏移。值为0表示最高有效位，值为7表示正在读取的字节的最低有效位。
    位偏移量被设置为0时，流被第一次打开，并且通过调用复位为0至seek ， skipBytes ，或任何read或readFully方法。
    
    结果
    
    一个 int其中包含0和7之间的位偏移量，包括0和7。
    
    异常
    
    IOException - 如果发生I / O错误。
    
    另请参见：
    
    setBitOffset(int)
  - setBitOffset
```
void setBitOffset(int bitOffset)
           throws IOException
```
    将位偏移设置为0到7之间的整数，包括0和7。 getStreamPosition返回的流内的字节偏移量保持不变。值为0表示最高有效位，值为7表示正在读取的字节的最低有效位。
    
    参数
    
    bitOffset - 所需的偏移量，为0和7之间的 int ，包括0和7。
    
    异常
    
    IllegalArgumentException - 如果 bitOffset不在0和7之间，包括0和7。
    
    IOException - 如果发生I / O错误。
    
    另请参见：
    
    getBitOffset()
  - readBit
```
int readBit()
     throws IOException
```
    从流中读取一个位，并将其作为int返回，值为0或1 。位偏移前进一并减少模8。
    
    结果
    
    一个 int包含值 0或 1 。
    
    异常
    
    EOFException - 如果流在读取所有位之前到达结束。
    
    IOException - 如果发生I / O错误。
  - readBits
```
long readBits(int numBits)
       throws IOException
```
    从流读取一个bitstring，并将其作为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(); }  
```
    需要注意的是的结果readBits(32)可因此不等于的readInt() ，如果正在使用的反向网络字节顺序（即， getByteOrder() == false ）。
    如果在读取所有位之前遇到流的结尾，则抛出java.io.EOFException 。
    参数
    
    numBits -比特数来读取，作为 int 0至64，包括端值。
    
    结果
    
    bitstring，作为 long与最后一位读取存储在最低有效位。
    
    异常
    
    IllegalArgumentException - 如果 numBits不在0和64之间（含）。
    
    EOFException - 如果流在读取所有位之前到达结束。
    
    IOException - 如果发生I / O错误。
  - length
```
long length()
     throws IOException
```
    如果已知，返回流的总长度。否则返回-1 。
    
    结果
    
    一个 long包含流的长度，如果知道，否则 -1 。
    
    异常
    
    IOException - 如果发生I / O错误。
  - skipBytes
```
int skipBytes(int n)
       throws IOException
```
    将流位置向前移动给定数量的字节。这种方法可能只能以比所请求的更少的字节向前跳过，例如，如果到达流的结尾。在所有情况下，返回实际跳过的字节数。位置偏移在前进位置之前设置为零。
    
    Specified by:
    
    skipBytes在界面 DataInput
    
    参数
    
    n - 包含要跳过的字节数的 int 。
    
    结果
    
    一个 int表示跳过的字节数。
    
    异常
    
    IOException - 如果发生I / O错误。
  - skipBytes
```
long skipBytes(long n)
        throws IOException
```
    将流位置向前移动给定数量的字节。该方法与skipBytes(int)相同，只是允许较大的跳跃距离。
    
    参数
    
    n - 包含要跳过的字节数的 long 。
    
    结果
    
    一个 long表示跳过的字节数。
    
    异常
    
    IOException - 如果发生I / O错误。
  - seek
```
void seek(long pos)
   throws IOException
```
    将当前流位置设置为所需位置。下一次读取将发生在此位置。位偏移设置为0。
    一个IndexOutOfBoundsException如果将被抛出pos比冲洗位置（如通过返回较小getflushedPosition ）。
    
    寻求文件结尾是合法的; 一个java.io.EOFException会，如果执行读取只抛出。
    
    参数
    
    pos - 一个 long所需文件指针位置的long。
    
    异常
    
    IndexOutOfBoundsException - 如果 pos小于冲洗位置。
    
    IOException - 如果发生任何其他I / O错误。
  - mark
```
void mark()
```
    在流中标记要通过后续呼叫返回到reset 。与标准InputStream不同，所有ImageInputStream都支持标记。此外，来电mark和reset可以任意地嵌套。
    与Reader和InputStream接口声明的mark方法不同，不readLimit readLimit参数。在调用mark可以读取任意数量的数据。
    
    通过mark和reset的每对呼叫保存并恢复readBits方法使用的位位置。
    
    请注意，它是有效的为ImageReader打电话flushBefore作为读取操作的一部分。因此，如果一个应用程序调用mark传递一个流的前ImageReader ，该应用程序不应该假定标记位置将保持有效的读操作完成后。
  - reset
```
void reset()
    throws IOException
```
    在最近不匹配的呼叫到mark的时候，返回到前一个位置的流指针，包括位偏移量。
    拨打reset没有对应的呼叫mark没有任何效果。
    
    一个IOException如果先前的标记位置位于流的丢弃部分将被抛出。
    
    异常
    
    IOException - 如果发生I / O错误。
  - flushBefore
```
void flushBefore(long pos)
          throws IOException
```
    在指示的位置之前丢弃流的初始部分。尝试寻求在流的冲洗部分内的偏移将导致IndexOutOfBoundsException 。
    调用flushBefore可能允许实现此接口的类释放用于从流中存储数据的资源（如内存或磁盘空间）。
    
    参数
    
    pos - 一个 long其中包含可能被刷新的流前缀的长度。
    
    异常
    
    IndexOutOfBoundsException - 如果 pos位于流的冲洗部分或超过当前流位置。
    
    IOException - 如果发生I / O错误。
  - flush
```
void flush()
    throws IOException
```
    在当前流位置之前丢弃流的初始位置。相当于flushBefore(getStreamPosition()) 。
    
    异常
    
    IOException - 如果发生I / O错误。
  - getFlushedPosition
```
long getFlushedPosition()
```
    返回可以执行搜索的流中的最早位置。返回的值将是传递到先前调用的所有值的最大值为flushBefore 。
    
    结果
    
    最早寻求法定职位，作为 long 。
  - isCached
```
boolean isCached()
```
    如果ImageInputStream缓存数据本身以返回true ，则返回。为了节省高速缓存资源，应用程序可以参考这一点，以确定刷新频率或是否进行刷新。
    
    结果
    
    true如果这个 ImageInputStream缓存数据。
    
    另请参见：
    
    isCachedMemory() ， isCachedFile()
  - isCachedMemory
```
boolean isCachedMemory()
```
    返回true如果这ImageInputStream缓存数据本身为了允许向后搜索，缓存保存在主内存中。为了节省高速缓存资源，应用程序可以参考这一点，以确定刷新频率或是否进行刷新。
    
    结果
    
    true如果这 ImageInputStream缓存数据在主内存中。
    
    另请参见：
    
    isCached() ， isCachedFile()
  - isCachedFile
```
boolean isCachedFile()
```
    返回true如果这ImageInputStream高速缓存数据本身以允许向后搜索，缓存保存在临时文件中。为了节省高速缓存资源，应用程序可以参考这一点，以确定刷新频率或是否进行刷新。
    
    结果
    
    true如果这个 ImageInputStream缓存数据在一个临时文件。
    
    另请参见：
    
    isCached() ， isCachedMemory()
  - close
```
void close()
    throws IOException
```
    关闭流。尝试访问已关闭的流可能会导致IOException或错误的行为。调用此方法可能允许实现此接口的类释放与流相关的资源，如内存，磁盘空间或文件描述符。
    
    Specified by:
    
    close在界面 AutoCloseable
    
    Specified by:
    
    close在界面 Closeable
    
    异常
    
    IOException - 如果发生I / O错误。

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.

Interface ImageInputStream

方法摘要

方法详细信息

setByteOrder

getByteOrder

read

read

read

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