ImageInputStreamImpl

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

javax.imageio.stream
类 ImageInputStreamImpl

java.lang.Object
  javax.imageio.stream.ImageInputStreamImpl

所有已实现的接口：: DataInput, ImageInputStream

直接已知子类：: FileCacheImageInputStream, FileImageInputStream, ImageOutputStreamImpl, MemoryCacheImageInputStream

public abstract class ImageInputStreamImpl
extends Object
implements ImageInputStream

实现 ImageInputStream 接口的抽象类。此类设计用于减少必须由子类实现的方法数。

需要特别指出的是，此类处理大部分或全部关于字节顺序解释、缓冲、标记/重置、丢弃、关闭和释放的详细资料。

字段摘要
`protected int`	`bitOffset` 流中的当前位偏移量。
`protected ByteOrder`	`byteOrder` 流的字节顺序，其为枚举类 `java.nio.ByteOrder` 的实例，其中 `ByteOrder.BIG_ENDIAN` 指示网络字节顺序，`ByteOrder.LITTLE_ENDIAN` 指示反向顺序。
`protected long`	`flushedPos` 可能丢弃的数据前面的那个位置。
`protected long`	`streamPos` 流中的当前读取位置。

构造方法摘要
`ImageInputStreamImpl()` 构造一个 `ImageInputStreamImpl`。

方法摘要
`protected void`	`checkClosed()` 如果已经关闭流，则抛出 `IOException`。
`void`	`close()` 关闭流。
`protected void`	`finalize()` 在垃圾回收前结束此对象。
`void`	`flush()` 丢弃当前流位置之前的流初始部分。
`void`	`flushBefore(long pos)` 丢弃所指示位置之前的流初始部分。
`int`	`getBitOffset()` 以整数的形式返回当前位偏移量，该整数在 0 到 7 之间（包含两者）。
`ByteOrder`	`getByteOrder()` 以 `java.nio.ByteOrder` 枚举实例的形式返回从此流中读取数据值时所使用的字节顺序。
`long`	`getFlushedPosition()` 返回流中可以执行查找的最早位置。
`long`	`getStreamPosition()` 返回流的当前字节位置。
`boolean`	`isCached()` 默认实现返回 false。
`boolean`	`isCachedFile()` 默认实现返回 false。
`boolean`	`isCachedMemory()` 默认实现返回 false。
`long`	`length()` 返回 `-1L`，指示流的长度未知。
`void`	`mark()` 将当前流位置推进到标记位置的堆栈上。
`abstract int`	`read()` 从流中读取单个字节，并以 `int`（0 到 255 之间）形式返回该字节。
`int`	`read(byte[] b)` 调用 `read(b, 0, b.length)` 的便捷方法。
`abstract int`	`read(byte[] b, int off, int len)` 从流中读取至多 `len` 个字节，并将其存储到 `b` 中（从 `off` 索引处开始）。
`int`	`readBit()` 从流中读取单个字节，并以 `int`（`0` 或 `1`）的形式返回该字节。
`long`	`readBits(int numBits)` 从流中读取位串 (bitstring) 并以 `long` 的形式返回，使第一个读取的位成为输出的最高有效位。
`boolean`	`readBoolean()` 从流中读取一个字节，如果其不为 0，则返回 `boolean` 值 `true`；如果为 0，则返回 `false`。
`byte`	`readByte()` 从流中读取一个字节，并以 `byte` 值的形式返回该字节。
`void`	`readBytes(IIOByteBuffer buf, int len)` 从流中读取至多 `len` 个字节，并修改提供的 `IIOByteBuffer` 以指示可以找到数据的 byte 数组、偏移量和长度。
`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` 个 char（无符号 16 位整数），并将其存储到 `c` 中（从索引 `off` 开始）。
`void`	`readFully(double[] d, int off, int len)` 根据当前字节顺序从流中读取 `len` 个 double（64 位 IEEE 双精度浮点值），并将其存储到 `d` 中（从索引 `off` 开始）。
`void`	`readFully(float[] f, int off, int len)` 根据当前字节顺序从流中读取 `len` 个 float（32 位 IEEE 单精度浮点值），并将其存储到 `f` 中（从索引 `off` 开始）。
`void`	`readFully(int[] i, int off, int len)` 根据当前字节顺序从流中读取 `len` 个 int（有符号 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` 个 short（有符号 16 位整数），并将其存储到 `s` 中（从索引 `off` 开始）。
`int`	`readInt()` 从流中读取 4 个字节，根据当前字节顺序将其连接（概念上），然后以 `int` 值的形式返回结果。
`String`	`readLine()` 从输入流中读取文本的下一行。
`long`	`readLong()` 从流中读取 8 个字节，根据当前字节顺序将其连接（概念上），然后以 `long` 值的形式返回结果。
`short`	`readShort()` 从流中读取两个字节，根据当前字节顺序将其连接（概念上），然后以 `short` 值的形式返回结果。
`int`	`readUnsignedByte()` 从流中读取一个字节，将其转换为 int（概念上），使用 `0xff` 屏蔽以便去掉所有符号扩展位，然后以 `byte` 值的形式返回。
`long`	`readUnsignedInt()` 从流中读取 4 个字节，根据当前字节顺序将其连接（概念上），将得到的值转换为 long，使用 `0xffffffffL` 屏蔽以便去掉所有符号扩展位，然后以无符号 `long` 值的形式返回结果。
`int`	`readUnsignedShort()` 从流中读取两个字节，根据当前字节顺序将其连接（概念上），将得到的值转换为 `int`，使用 `0xffff` 屏蔽以便去掉所有符号扩展位，然后以无符号 `int` 值的形式返回结果。
`String`	`readUTF()` 读入一个已使用 UTF-8 修改版格式编码的字符串。
`void`	`reset()` 根据标记的堆栈重置当前流字节和位位置。
`void`	`seek(long pos)` 将当前流位置设置为所需的位置。
`void`	`setBitOffset(int bitOffset)` 将位偏移量设置为 0 到 7 之间（包含两者）的整数。
`void`	`setByteOrder(ByteOrder byteOrder)` 设置希望以后从此流中读取数据值时使用的字节顺序。
`int`	`skipBytes(int n)` 通过调用 `seek(getStreamPosition() + n)` 推进当前流位置。
`long`	`skipBytes(long n)` 通过调用 `seek(getStreamPosition() + n)` 推进当前流位置。

从类 java.lang.Object 继承的方法
`clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

字段详细信息

byteOrder

protected ByteOrder byteOrder

流的字节顺序，其为枚举类 java.nio.ByteOrder 的实例，其中 ByteOrder.BIG_ENDIAN 指示网络字节顺序，ByteOrder.LITTLE_ENDIAN 指示反向顺序。默认情况下，该值为 ByteOrder.BIG_ENDIAN。

streamPos

protected long streamPos

流中的当前读取位置。子类负责根据其重写的任何会改变读取位置的方法保持此值最新。

bitOffset

protected int bitOffset

流中的当前位偏移量。子类负责根据其重写的任何会改变位偏移量的方法保持此值最新。

flushedPos

protected long flushedPos

可能丢弃的数据前面的那个位置。不允许查找较小的位置。flushedPos 将总是 >= 0。

构造方法详细信息

public ImageInputStreamImpl()

构造一个 ImageInputStreamImpl。

方法详细信息

checkClosed

protected final void checkClosed()
                          throws IOException

如果已经关闭流，则抛出 IOException。子类可以从其任何要求不关闭流的方法中调用此方法。

抛出：: IOException - 如果已关闭流。

setByteOrder

public void setByteOrder(ByteOrder byteOrder)

从接口 ImageInputStream 复制的描述

设置希望以后从此流中读取数据值时使用的字节顺序。例如，如果以 4 字节整数形式读取字节序列 '0x01 0x02 0x03 0x04'，则使用网络字节顺序时结果为值 '0x01020304'，使用逆向字节顺序时为值 '0x04030201'。

枚举类 java.nio.ByteOrder 用于指定字节顺序。值 ByteOrder.BIG_ENDIAN 指定所谓的 big-endian 或网络字节顺序，该顺序中高位字节在前。Motorola 和 Sparc 处理器用此格式存储数据，而 Intel 处理器使用与之相反的 ByteOrder.LITTLE_ENDIAN 顺序存储数据。

字节顺序对 readBits 方法返回的结果（或 ImageOutputStream.writeBits 写入的值）没有任何影响。

指定者：: 接口 ImageInputStream 中的 setByteOrder

参数：: byteOrder - ByteOrder.BIG_ENDIAN 或 java.nio.ByteOrder.LITTLE_ENDIAN，指示以后读取时是使用网络顺序还是使用与之相反的顺序。
另请参见：: ByteOrder, ImageInputStream.getByteOrder(), ImageInputStream.readBits(int)

getByteOrder

public ByteOrder getByteOrder()

从接口 ImageInputStream 复制的描述

以 java.nio.ByteOrder 枚举实例的形式返回从此流中读取数据值时所使用的字节顺序。

指定者：: 接口 ImageInputStream 中的 getByteOrder

返回：: ByteOrder.BIG_ENDIAN 或 ByteOrder.LITTLE_ENDIAN，指示要使用的字节顺序。
另请参见：: ByteOrder, ImageInputStream.setByteOrder(java.nio.ByteOrder)

read

public abstract int read()
                  throws IOException

从流中读取单个字节，并以 int（0 到 255 之间）形式返回该字节。如果到达 EOF，则返回 -1。

子类必须提供此方法的实现。子类实现在退出前应该更新流位置。

在发生读取前，流中的位偏移量必须被重置为 0。

指定者：: 接口 ImageInputStream 中的 read

返回：: 流中下一个字节的值；如果到达 EOF，则返回 -1。
抛出：: IOException - 如果流已经被关闭。

read

public int read(byte[] b)
         throws IOException

调用 read(b, 0, b.length) 的便捷方法。

在发生读取前，流中的位偏移量被重置为 0。

指定者：: 接口 ImageInputStream 中的 read

参数：: b - 用来接收写入的 byte 数组。
返回：: 实际读取的字节数；或者 -1，指示 EOF。
抛出：: NullPointerException - 如果 b 为 null。; IOException - 如果发生 I/O 错误。

read

public abstract int read(byte[] b,
                         int off,
                         int len)
                  throws IOException

从流中读取至多 len 个字节，并将其存储到 b 中（从 off 索引处开始）。如果由于到达流末尾而没有读取任何字节，则返回 -1。

在发生读取前，流中的位偏移量必须被重置为 0。

子类必须提供此方法的实现。子类实现在退出前应该更新流位置。

指定者：: 接口 ImageInputStream 中的 read

参数：: b - 用来接收写入的字节数组。; off - b 中要写入的起始位置。; len - 要读取的最大字节数。

返回：

实际读取的字节数；或者 -1，指示 EOF。

抛出：

IndexOutOfBoundsException - 如果 off 为负、len 为负或者 off + len 大于 b.length。

NullPointerException - 如果 b 为 null。

IOException - 如果发生 I/O 错误。

readBytes

public void readBytes(IIOByteBuffer buf,
                      int len)
               throws IOException

从接口 ImageInputStream 复制的描述

从流中读取至多 len 个字节，并修改提供的 IIOByteBuffer 以指示可以找到数据的 byte 数组、偏移量和长度。调用者不应该试图修改 IIOByteBuffer 中找到的数据。

在进行读取前，流中的位偏移量被重置为 0。

指定者：: 接口 ImageInputStream 中的 readBytes

参数：: buf - 要修改的 IIOByteBuffer 对象。; len - 要读取的最大 byte 数。

抛出：

IOException - 如果发生 I/O 错误。

readBoolean

public boolean readBoolean()
                    throws IOException

从接口 ImageInputStream 复制的描述

从流中读取一个字节，如果其不为 0，则返回 boolean 值 true；如果为 0，则返回 false。

在进行读取前，流中的位偏移量被重置为 0。

指定者：: 接口 DataInput 中的 readBoolean
指定者：: 接口 ImageInputStream 中的 readBoolean

返回：: 取自流的 boolean 值。
抛出：: EOFException - 如果到达流末尾。; IOException - 如果发生 I/O 错误。

readByte

public byte readByte()
              throws IOException

从接口 ImageInputStream 复制的描述

从流中读取一个字节，并以 byte 值的形式返回该字节。0x00 到 0x7f 之间的字节值表示 0 到 127 之间的整数值。0x80 到 0xff 之间的字节值表示 -128 到 -1 之间的负整数值。

在进行读取前，流中的位偏移量被重置为 0。

指定者：: 接口 DataInput 中的 readByte
指定者：: 接口 ImageInputStream 中的 readByte

返回：: 取自流的单个字节值。
抛出：: EOFException - 如果到达流末尾。; IOException - 如果发生 I/O 错误。

readUnsignedByte

public int readUnsignedByte()
                     throws IOException

从接口 ImageInputStream 复制的描述

从流中读取一个字节，将其转换为 int（概念上），使用 0xff 屏蔽以便去掉所有符号扩展位，然后以 byte 值的形式返回。

于是，0x00 到 0x7f 之间的字节值便作为 0 到 127 之间的整数值返回。0x80 到 0xff 之间的字节值通常表示为负的 byte 值，它们将被映射成 128 到 255 之间的正整数。

在进行读取前，流中的位偏移量被重置为 0。

指定者：: 接口 DataInput 中的 readUnsignedByte
指定者：: 接口 ImageInputStream 中的 readUnsignedByte

返回：: 取自流的无符号 byte 值。
抛出：: EOFException - 如果到达流末尾。; IOException - 如果发生 I/O 错误。

readShort

public short readShort()
                throws IOException

从接口 ImageInputStream 复制的描述

从流中读取两个字节，根据当前字节顺序将其连接（概念上），然后以 short 值的形式返回结果。

在进行读取前，流中的位偏移量被重置为 0。

指定者：: 接口 DataInput 中的 readShort
指定者：: 接口 ImageInputStream 中的 readShort

返回：: 取自流的有符号 short 值。
抛出：: EOFException - 如果该流在读取所有字节之前到达末尾。; IOException - 如果发生 I/O 错误。

另请参见：

ImageInputStream.getByteOrder()

readUnsignedShort

public int readUnsignedShort()
                      throws IOException

从接口 ImageInputStream 复制的描述

从流中读取两个字节，根据当前字节顺序将其连接（概念上），将得到的值转换为 int，使用 0xffff 屏蔽以便去掉所有符号扩展位，然后以无符号 int 值的形式返回结果。

在进行读取前，流中的位偏移量被重置为 0。

指定者：: 接口 DataInput 中的 readUnsignedShort
指定者：: 接口 ImageInputStream 中的 readUnsignedShort

返回：: 取自流的无符号 short 值（int 形式）。
抛出：: EOFException - 如果该流在读取所有字节之前到达末尾。; IOException - 如果发生 I/O 错误。

另请参见：

ImageInputStream.getByteOrder()

readChar

public char readChar()
              throws IOException

从接口 ImageInputStream 复制的描述

与 readUnsignedShort 等效，唯一的不同在于它的结果使用 char 数据类型返回。

在进行读取前，流中的位偏移量被重置为 0。

指定者：: 接口 DataInput 中的 readChar
指定者：: 接口 ImageInputStream 中的 readChar

返回：: 取自流的无符号 char 值。
抛出：: EOFException - 如果该流在读取所有字节之前到达末尾。; IOException - 如果发生 I/O 错误。

另请参见：

ImageInputStream.readUnsignedShort()

readInt

public int readInt()
            throws IOException

从接口 ImageInputStream 复制的描述

从流中读取 4 个字节，根据当前字节顺序将其连接（概念上），然后以 int 值的形式返回结果。

忽略流中的位偏移量，将其视为 0。

指定者：: 接口 DataInput 中的 readInt
指定者：: 接口 ImageInputStream 中的 readInt

返回：: 取自流的有符号 int 值。
抛出：: EOFException - 如果该流在读取所有字节之前到达末尾。; IOException - 如果发生 I/O 错误。

另请参见：

ImageInputStream.getByteOrder()

readUnsignedInt

public long readUnsignedInt()
                     throws IOException

从接口 ImageInputStream 复制的描述

从流中读取 4 个字节，根据当前字节顺序将其连接（概念上），将得到的值转换为 long，使用 0xffffffffL 屏蔽以便去掉所有符号扩展位，然后以无符号 long 值的形式返回结果。

在进行读取前，流中的位偏移量被重置为 0。

指定者：: 接口 ImageInputStream 中的 readUnsignedInt

返回：: 取自流的无符号 int 值（long 形式）。
抛出：: EOFException - 如果该流在读取所有字节之前到达末尾。; IOException - 如果发生 I/O 错误。

另请参见：

ImageInputStream.getByteOrder()

readLong

public long readLong()
              throws IOException

从接口 ImageInputStream 复制的描述

从流中读取 8 个字节，根据当前字节顺序将其连接（概念上），然后以 long 值的形式返回结果。

在进行读取前，流中的位偏移量被重置为 0。

指定者：: 接口 DataInput 中的 readLong
指定者：: 接口 ImageInputStream 中的 readLong

返回：: 取自流的有符号 long 值。
抛出：: EOFException - 如果该流在读取所有字节之前到达末尾。; IOException - 如果发生 I/O 错误。

另请参见：

ImageInputStream.getByteOrder()

readFloat

public float readFloat()
                throws IOException

从接口 ImageInputStream 复制的描述

从流中读取 4 个字节，根据当前字节顺序将其连接（概念上），然后以 float 值的形式返回结果。

在进行读取前，流中的位偏移量被重置为 0。

指定者：: 接口 DataInput 中的 readFloat
指定者：: 接口 ImageInputStream 中的 readFloat

返回：: 取自流的 float 值。
抛出：: EOFException - 如果该流在读取所有字节之前到达末尾。; IOException - 如果发生 I/O 错误。

另请参见：

ImageInputStream.getByteOrder()

readDouble

public double readDouble()
                  throws IOException

从接口 ImageInputStream 复制的描述

从流中读取 8 个字节，根据当前字节顺序将其连接（概念上），然后以 double 值的形式返回结果。

在进行读取前，流中的位偏移量被重置为 0。

指定者：: 接口 DataInput 中的 readDouble
指定者：: 接口 ImageInputStream 中的 readDouble

返回：: 取自流的 double 值。
抛出：: EOFException - 如果该流在读取所有字节之前到达末尾。; IOException - 如果发生 I/O 错误。

另请参见：

ImageInputStream.getByteOrder()

readLine

public String readLine()
                throws IOException

从接口 ImageInputStream 复制的描述

从输入流中读取文本的下一行。该方法读取连续的字节，将每个字节分别转换成一个字符，直到遇到行结尾符或文件结束标记；然后以 String 形式返回读取的字符。注意，因为此方法处理字符，所以它不支持整个 Unicode 字符集的输入。

如果在一个字节都没有读取的时候就遇到文件结束标记，则返回 null。否则，通过左侧补 0 将读取的每个字节转换成 char 类型的值。如果遇到字符 '\n'，则丢弃它并且停止读取。如果遇到字符 '\r'，则丢弃它；如果它后面的那个字节转变成字符 '\n'，则同样丢弃它，并且停止读取。如果在遇到字符 '\n' 和 '\r' 之一前遇到文件结束标记，则停止读取。一旦已停止读取，则返回一个 String，它按顺序包含所有已读取且未丢弃的字符。注意，此字符串中的每个字符的值都将小于 \u0100（即 (char)256）的值。

在进行读取前，流中的位偏移量被重置为 0。

指定者：: 接口 DataInput 中的 readLine
指定者：: 接口 ImageInputStream 中的 readLine

返回：: 一个 String，它包含取自流的一行文本。
抛出：: IOException - 如果发生 I/O 错误。

readUTF

public String readUTF()
               throws IOException

从接口 ImageInputStream 复制的描述

读入一个已使用 UTF-8 修改版格式编码的字符串。readUTF 的常规协定是：该方法读取使用 UTF-8 修改版格式编码的 Unicode 字符串的表示形式；然后以 String 的形式返回此字符串。

首先，读取两个字节并按 readUnsignedShort 方法的方式使用这两个字节构造一个无符号 16 位整数，使用的是网络字节顺序（无论当前设置的是哪种字节顺序）。该整数值被称为 UTF 长度，它指定要读取的额外字节数。然后成组地将这些字节转换为字符。每组的长度根据该组第一个字节的值计算。紧跟在某个组后面的字节（如果有）是下一组的第一个字节。

如果组的第一个字节与位模式 0xxxxxxx（其中 x 表示“可能为 0 或 1”）匹配，则该组只有这一个字节。该字节被左侧补 0，转换成一个字符。

如果组的第一个字节与位模式 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。

如果在整个执行过程中的任意时间遇到文件结束标记，则抛出 EOFException。

在通过此过程将每个组转换成字符后，按照从输入流中读取相应组的顺序，将这些字符收集在一起，形成一个 String，然后该字符串将被返回。

忽略当前设置的字节顺序。

在进行读取前，流中的位偏移量被重置为 0。

注：在使用标准 UTF-8 图像格式的实现中不应该使用此方法，因为此处使用的 UTF-8 修改版与标准 UTF-8 不兼容。

指定者：: 接口 DataInput 中的 readUTF
指定者：: 接口 ImageInputStream 中的 readUTF

返回：: 从流中读取的 String。
抛出：: EOFException - 如果此流在读取所有字节之前到达末尾。; UTFDataFormatException - 如果这些字节不表示一个有效的、UTF-8 修改版编码的字符串。; IOException - 如果发生 I/O 错误。

readFully

public void readFully(byte[] b,
                      int off,
                      int len)
               throws IOException

从接口 ImageInputStream 复制的描述

从流中读取 len 个字节，并将其存储到 b 中（从索引 off 开始）。如果到达流末尾，则将抛出 EOFException。

在进行读取前，流中的位偏移量被重置为 0。

指定者：: 接口 DataInput 中的 readFully
指定者：: 接口 ImageInputStream 中的 readFully

参数：: b - 用来接收写入的 byte 数组。; off - 向 b 进行写入的开始位置。; len - 要读取的最大 byte 数。

抛出：

EOFException - 如果该流在读取所有字节之前到达末尾。

IOException - 如果发生 I/O 错误。

readFully

public void readFully(byte[] b)
               throws IOException

从接口 ImageInputStream 复制的描述

从流中读取 b.length 个字节，并将其存储到 b 中（从索引 0 开始）。如果到达流末尾，则将抛出 EOFException。

在进行读取前，流中的位偏移量被重置为 0。

指定者：: 接口 DataInput 中的 readFully
指定者：: 接口 ImageInputStream 中的 readFully

参数：: b - 一个 byte 数组。
抛出：: EOFException - 如果该流在读取所有字节之前到达末尾。; IOException - 如果发生 I/O 错误。

readFully

public void readFully(short[] s,
                      int off,
                      int len)
               throws IOException

从接口 ImageInputStream 复制的描述

根据当前字节顺序从流中读取 len 个 short（有符号 16 位整数），并将其存储到 s 中（从索引 off 开始）。如果到达流末尾，则将抛出 EOFException。

在进行读取前，流中的位偏移量被重置为 0。

指定者：: 接口 ImageInputStream 中的 readFully

参数：: s - 用来接收写入的 short 数组。; off - 向 s 进行写入的开始位置。; len - 要读取的最大 short 数。

抛出：

EOFException - 如果该流在读取所有字节之前到达末尾。

IOException - 如果发生 I/O 错误。

readFully

public void readFully(char[] c,
                      int off,
                      int len)
               throws IOException

从接口 ImageInputStream 复制的描述

根据当前字节顺序从流中读取 len 个 char（无符号 16 位整数），并将其存储到 c 中（从索引 off 开始）。如果到达流末尾，则将抛出 EOFException。

在进行读取前，流中的位偏移量被重置为 0。

指定者：: 接口 ImageInputStream 中的 readFully

参数：: c - 用来接收写入的 char 数组。; off - 向 c 进行写入的开始位置。; len - 要读取的最大 char 数。

抛出：

EOFException - 如果该流在读取所有字节之前到达末尾。

IOException - 如果发生 I/O 错误。

readFully

public void readFully(int[] i,
                      int off,
                      int len)
               throws IOException

从接口 ImageInputStream 复制的描述

根据当前字节顺序从流中读取 len 个 int（有符号 32 位整数），并将其存储到 i 中（从索引 off 开始）。如果到达流末尾，则将抛出 EOFException。

在进行读取前，流中的位偏移量被重置为 0。

指定者：: 接口 ImageInputStream 中的 readFully

参数：: i - 用来接收写入的 int 数组。; off - 向 i 进行写入的开始位置。; len - 要读取的最大 int 数。

抛出：

EOFException - 如果该流在读取所有字节之前到达末尾。

IOException - 如果发生 I/O 错误。

readFully

public void readFully(long[] l,
                      int off,
                      int len)
               throws IOException

从接口 ImageInputStream 复制的描述

根据当前字节顺序从流中读取 len 个 long（有符号 64 位整数），并将其存储到 l 中（从索引 off 开始）。如果到达流末尾，则将抛出 EOFException。

在进行读取前，流中的位偏移量被重置为 0。

指定者：: 接口 ImageInputStream 中的 readFully

参数：: l - 用来接收写入的 long 数组。; off - 向 l 进行写入的开始位置。; len - 要读取的最大 long 数。

抛出：

EOFException - 如果该流在读取所有字节之前到达末尾。

IOException - 如果发生 I/O 错误。

readFully

public void readFully(float[] f,
                      int off,
                      int len)
               throws IOException

从接口 ImageInputStream 复制的描述

根据当前字节顺序从流中读取 len 个 float（32 位 IEEE 单精度浮点值），并将其存储到 f 中（从索引 off 开始）。如果到达流末尾，则将抛出 EOFException。

在进行读取前，流中的位偏移量被重置为 0。

指定者：: 接口 ImageInputStream 中的 readFully

参数：: f - 用来接收写入的 float 数组。; off - 向 f 进行写入的开始位置。; len - 要读取的最大 float 数。

抛出：

EOFException - 如果该流在读取所有字节之前到达末尾。

IOException - 如果发生 I/O 错误。

readFully

public void readFully(double[] d,
                      int off,
                      int len)
               throws IOException

从接口 ImageInputStream 复制的描述

根据当前字节顺序从流中读取 len 个 double（64 位 IEEE 双精度浮点值），并将其存储到 d 中（从索引 off 开始）。如果到达流末尾，则将抛出 EOFException。

在进行读取前，流中的位偏移量被重置为 0。

指定者：: 接口 ImageInputStream 中的 readFully

参数：: d - 用来接收写入的 double 数组。; off - 向 d 进行写入的开始位置。; len - 要读取的最大 double 数。

抛出：

EOFException - 如果该流在读取所有字节之前到达末尾。

IOException - 如果发生 I/O 错误。

getStreamPosition

public long getStreamPosition()
                       throws IOException

从接口 ImageInputStream 复制的描述

返回流的当前字节位置。下一次读取将从此偏移量开始。

指定者：: 接口 ImageInputStream 中的 getStreamPosition

返回：: 一个包含流位置 long 值。
抛出：: IOException - 如果发生 I/O 错误。

getBitOffset

public int getBitOffset()
                 throws IOException

从接口 ImageInputStream 复制的描述

以整数的形式返回当前位偏移量，该整数在 0 到 7 之间（包含两者）。位偏移量通过调用 readBits 方法隐式地更新。值 0 表示所读取字节的最高有效位，值 7 表示所读取字节的最低有效位。

第一次打开流时位偏移量被设置为 0，以后可以通过调用 seek、skipBytes、或者任何 read 或 readFully 方法将其重置为 0。

指定者：: 接口 ImageInputStream 中的 getBitOffset

返回：: 一个 int，包含 0 到 7 之间（包含两者）的位偏移量。
抛出：: IOException - 如果发生 I/O 错误。
另请参见：: ImageInputStream.setBitOffset(int)

setBitOffset

public void setBitOffset(int bitOffset)
                  throws IOException

从接口 ImageInputStream 复制的描述

将位偏移量设置为 0 到 7 之间（包含两者）的整数。不改变流中由 getStreamPosition 返回的位偏移量。值 0 表示所读取字节的最高有效位，值 7 表示所读取字节的最低有效位。

指定者：: 接口 ImageInputStream 中的 setBitOffset

参数：: bitOffset - 所需的偏移量，为 0 到 7 之间（包括两者）的 int 的形式。
抛出：: IOException - 如果发生 I/O 错误。
另请参见：: ImageInputStream.getBitOffset()

readBit

public int readBit()
            throws IOException

从接口 ImageInputStream 复制的描述

从流中读取单个字节，并以 int（0 或 1）的形式返回该字节。位偏移量将加 1，模数将减 8。

指定者：: 接口 ImageInputStream 中的 readBit

返回：: 一个 int，包含 0 或 1。
抛出：: EOFException - 如果该流在读取所有位之前到达末尾。; IOException - 如果发生 I/O 错误。

readBits

public long readBits(int numBits)
              throws IOException

从接口 ImageInputStream 复制的描述

从流中读取位串 (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();
 }

注意，如果使用了与网络字节顺序相反的顺序（即 getByteOrder() == false），那么 readBits(32) 的结果可能因此而不等于 readInt() 的结果。

如果在读取了所有位前遇到流末尾，则抛出 EOFException。

指定者：: 接口 ImageInputStream 中的 readBits

参数：: numBits - 要读取的位数，为 0 到 64 之间（包含两者）的 int 形式。
返回：: long 形式的位串，最后读取的位存储在最低有效位中。
抛出：: EOFException - 如果该流在读取所有位之前到达末尾。; IOException - 如果发生 I/O 错误。

length

public long length()

返回 -1L，指示流的长度未知。子类必须重写此方法来提供实际的长度信息。

指定者：: 接口 ImageInputStream 中的 length

返回：: 指示不知道长度的 -1L。

skipBytes

public int skipBytes(int n)
              throws IOException

通过调用 seek(getStreamPosition() + n) 推进当前流位置。

位偏移量被重置为 0。

指定者：: 接口 DataInput 中的 skipBytes
指定者：: 接口 ImageInputStream 中的 skipBytes

参数：: n - 要逆向查找的字节数。
返回：: 一个 int，表示跳过的字节数。
抛出：: IOException - 如果 getStreamPosition 计算起始或结束位置时抛出 IOException。

skipBytes

public long skipBytes(long n)
               throws IOException

通过调用 seek(getStreamPosition() + n) 推进当前流位置。

位偏移量被重置为 0。

指定者：: 接口 ImageInputStream 中的 skipBytes

参数：: n - 要逆向查找的字节数。
返回：: 一个 long，表示跳过的字节数。
抛出：: IOException - 如果 getStreamPosition 计算起始或结束位置时抛出 IOException。

seek

public void seek(long pos)
          throws IOException

从接口 ImageInputStream 复制的描述

将当前流位置设置为所需的位置。下一次读取将在此位置上进行。位偏移量被设置为 0。

如果 pos 小于刷新位置（由 getflushedPosition 返回），那么将抛出 IndexOutOfBoundsException。

查找文件结束标记的后面是合法的，只有在该处执行读取时才抛出 EOFException。

指定者：: 接口 ImageInputStream 中的 seek

参数：: pos - 一个 long，它包含所需的文件指针位置。
抛出：: IOException - 如果发生任何 I/O 错误。

mark

public void mark()

将当前流位置推进到标记位置的堆栈上。

指定者：: 接口 ImageInputStream 中的 mark

reset

public void reset()
           throws IOException

根据标记的堆栈重置当前流字节和位位置。

如果以前的标记位置位于流的丢弃部分，则抛出 IOException。

指定者：: 接口 ImageInputStream 中的 reset

抛出：: IOException - 如果发生 I/O 错误。

flushBefore

public void flushBefore(long pos)
                 throws IOException

从接口 ImageInputStream 复制的描述

丢弃所指示位置之前的流初始部分。试图查找流的刷新部分中的偏移量将导致抛出 IndexOutOfBoundsException。

调用 flushBefore 可允许实现此接口的类释放存储流中的数据所使用的资源，如内存和磁盘空间。

指定者：: 接口 ImageInputStream 中的 flushBefore

参数：: pos - 一个 long，它包含要刷新的流前缀的长度。
抛出：: IOException - 如果发生 I/O 错误。

flush

public void flush()
           throws IOException

从接口 ImageInputStream 复制的描述

丢弃当前流位置之前的流初始部分。等效于 flushBefore(getStreamPosition())。

指定者：: 接口 ImageInputStream 中的 flush

抛出：: IOException - 如果发生 I/O 错误。

getFlushedPosition

public long getFlushedPosition()

从接口 ImageInputStream 复制的描述

返回流中可以执行查找的最早位置。返回值将是所有传入 flushBefore 上一次调用的值中的最大值。

指定者：: 接口 ImageInputStream 中的 getFlushedPosition

返回：: 用于查找的最早的合法位置（long 形式）。

isCached

public boolean isCached()

默认实现返回 false。如果子类缓存数据，则其应该重写此方法。

指定者：: 接口 ImageInputStream 中的 isCached

返回：: 如果此 ImageInputStream 缓存数据，则返回 true。
另请参见：: ImageInputStream.isCachedMemory(), ImageInputStream.isCachedFile()

isCachedMemory

public boolean isCachedMemory()

默认实现返回 false。如果子类在主存中缓存数据，则其应该重写此方法。

指定者：: 接口 ImageInputStream 中的 isCachedMemory

返回：: 如果此 ImageInputStream 在主存中缓存数据，则返回 true。
另请参见：: ImageInputStream.isCached(), ImageInputStream.isCachedFile()

isCachedFile

public boolean isCachedFile()

默认实现返回 false。如果子类在临时文件中缓存数据，则其应该重写此方法。

指定者：: 接口 ImageInputStream 中的 isCachedFile

返回：: 如果此 ImageInputStream 在临时文件中缓存数据，则返回 true。
另请参见：: ImageInputStream.isCached(), ImageInputStream.isCachedMemory()

close

public void close()
           throws IOException

从接口 ImageInputStream 复制的描述

关闭流。试图访问已经关闭的流将导致 IOException 或错误行为。调用此方法可允许实现此接口的类释放与流关联的资源，如内存、磁盘空间或文件描述符。

指定者：: 接口 ImageInputStream 中的 close

抛出：: IOException - 如果发生 I/O 错误。

finalize

protected void finalize()
                 throws Throwable

在垃圾回收前结束此对象。调用 close 方法来关闭所有开启的输入源。不应该从应用程序代码调用此方法。

覆盖：: 类 Object 中的 finalize

抛出：: Throwable - 如果在超类终止过程中发生错误。

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

javax.imageio.stream 类 ImageInputStreamImpl

byteOrder

streamPos

bitOffset

flushedPos