public abstract class InputStream
extends
Object
implements
Closeable
此抽象类是表示字节输入流的所有类的超类。
需要定义 InputStream
子类的应用程序必须总是提供返回下一个输入字节的方法。
read
public abstract int read()
throws IOException
从输入流中读取数据的下一个字节。返回
0
到
255
范围内的
int
字节值。如果因为已经到达流末尾而没有可用的字节,则返回值
-1
。在输入数据可用、检测到流末尾或者抛出异常前,此方法一直阻塞。
子类必须提供此方法的一个实现。
返回:
下一个数据字节;如果到达流的末尾,则返回
-1
。
抛出:
IOException
- 如果发生 I/O 错误。
read
public int read(byte[] b) throws IOException
从输入流中读取一定数量的字节,并将其存储在缓冲区数组
b
中。以整数形式返回实际读取的字节数。在输入数据可用、检测到文件末尾或者抛出异常前,此方法一直阻塞。
如果 b
的长度为 0,则不读取任何字节并返回 0
;否则,尝试读取至少一个字节。如果因为流位于文件末尾而没有可用的字节,则返回值 -1
;否则,至少读取一个字节并将其存储在 b
中。
将读取的第一个字节存储在元素 b[0]
中,下一个存储在 b[1]
中,依次类推。读取的字节数最多等于 b
的长度。设 k 为实际读取的字节数;这些字节将存储在 b[0]
到 b[
k-1]
的元素中,不影响 b[
k]
到 b[b.length-1]
的元素。
类 InputStream
的 read(b)
方法的效果等同于:
read(b, 0, b.length)
参数:
b
- 存储读入数据的缓冲区。
返回:
读入缓冲区的总字节数;如果因为已经到达流末尾而不再有数据可用,则返回
-1
。
抛出:
IOException
- 如果不是因为流位于文件末尾而无法读取第一个字节;如果输入流已关闭;如果发生其他 I/O 错误。
NullPointerException
- 如果
b
为
null
。
另请参见:
read
public int read(byte[] b, int off, int len) throws IOException
将输入流中最多
len
个数据字节读入 byte 数组。尝试读取
len
个字节,但读取的字节也可能小于该值。以整数形式返回实际读取的字节数。
在输入数据可用、检测到流末尾或者抛出异常前,此方法一直阻塞。
如果 len
为 0,则不读取任何字节并返回 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]
的元素都不会受到影响。
类 InputStream
的 read(b,
off,
len)
方法重复调用方法 read()
。如果第一次这样的调用导致 IOException
,则从对 read(b,
off,
len)
方法的调用中返回该异常。如果对 read()
的任何后续调用导致 IOException
,则捕获该异常并将其视为到达文件末尾;到达该点时读取的字节存储在 b
中,并返回发生异常之前读取的字节数。在已读取输入数据 len
的请求数量、检测到文件结束标记、抛出异常前,此方法的默认实现将一直阻塞。建议子类提供此方法更为有效的实现。
参数:
b
- 读入数据的缓冲区。
off
- 数组
b
中将写入数据的初始偏移量。
len
- 要读取的最大字节数。
返回:
读入缓冲区的总字节数;如果因为已到达流末尾而不再有数据可用,则返回
-1
。
抛出:
IOException
- 如果不是因为位于文件末尾而无法读取第一个字节;如果输入流已关闭;如果发生其他 I/O 错误。
NullPointerException
- 如果
b
为
null
。
IndexOutOfBoundsException
- 如果
off
为负,
len
为负,或者
len
大于
b.length - off
另请参见:
read()