InputStream.Read 方法

定义

重载

名称 说明
Read()

从输入流中读取下一字节的数据。

Read(Byte[])

从输入流中读取一些字节并将其存储到缓冲区数组 b中。

Read(Byte[], Int32, Int32)

将数据从输入流读取到 len 字节数组中最多字节数。

Read()

从输入流中读取下一字节的数据。

[Android.Runtime.Register("read", "()I", "GetReadHandler")]
public abstract int Read();
[<Android.Runtime.Register("read", "()I", "GetReadHandler")>]
abstract member Read : unit -> int

返回

下一个字节的数据,或者 -1 到达流的末尾。

属性

例外

如果流已关闭,或者发生另一个 IOException,

注解

从输入流中读取下一字节的数据。 值字节作为范围0中的字节返回int255 如果没有字节可用,因为已达到流的末尾,则返回该值 -1 。 此方法会阻止输入数据可用、检测到流的末尾或引发异常。

子类必须提供此方法的实现。

Java文档java.io.InputStream.read()

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

适用于

Read(Byte[])

从输入流中读取一些字节并将其存储到缓冲区数组 b中。

[Android.Runtime.Register("read", "([B)I", "GetRead_arrayBHandler")]
public virtual int Read(byte[]? b);
[<Android.Runtime.Register("read", "([B)I", "GetRead_arrayBHandler")>]
abstract member Read : byte[] -> int
override this.Read : byte[] -> int

参数

b
Byte[]

读取数据的缓冲区。

返回

读取到缓冲区中的字节总数,或者 -1 由于已到达流的末尾而没有更多数据。

属性

例外

注解

从输入流中读取一些字节并将其存储到缓冲区数组 b中。 实际读取的字节数作为整数返回。 此方法会阻止输入数据可用、检测到文件末尾或引发异常。

如果长度 b 为零,则不读取字节并 0 返回;否则,尝试读取至少一个字节。 如果没有字节可用,因为流位于文件末尾,则返回该值 -1 ;否则,至少读取一个字节并将其存储到 b其中。

第一个字节读取存储在元素 b[0]中,下一个字节读取将存储到 b[1]元素中,依如此。 读取的字节数最多等于长度 b。 让 k 成为实际读取的字节数;这些字节将通过 k-1] 存储在元素中,使元素 b[b[b[0]k]b[b.length-1]受影响。

read(b)InputStream的方法的效果与:

{@code read(b, 0, b.length) }

Java文档java.io.InputStream.read(byte[])

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

适用于

Read(Byte[], Int32, Int32)

将数据从输入流读取到 len 字节数组中最多字节数。

[Android.Runtime.Register("read", "([BII)I", "GetRead_arrayBIIHandler")]
public virtual int Read(byte[]? b, int off, int len);
[<Android.Runtime.Register("read", "([BII)I", "GetRead_arrayBIIHandler")>]
abstract member Read : byte[] * int * int -> int
override this.Read : byte[] * int * int -> int

参数

b
Byte[]

读取数据的缓冲区。

off
Int32

写入数据的数组 b 中的起始偏移量。

len
Int32

要读取的最大字节数。

返回

读取到缓冲区中的字节总数,或者 -1 由于已到达流的末尾而没有更多数据。

属性

例外

如果 byteOffset buffer.length

如果流已关闭,或者发生另一个 IOException,

注解

将数据从输入流读取到 len 字节数组中最多字节数。 尝试读取尽可能多的 len 字节,但可以读取较小的数字。 实际读取的字节数作为整数返回。

此方法会阻止输入数据可用、检测到文件末尾或引发异常。

如果 len 为零,则不读取字节并 0 返回;否则,尝试读取至少一个字节。 如果没有字节可用,因为流位于文件末尾,则返回该值 -1 ;否则,至少读取一个字节并将其存储到 b其中。

第一个字节读取存储在元素 b[off]中,下一个字节读取将存储到 b[off+1]元素中,依如此。 读取的字节数最多等于 len。 让 k 成为实际读取的字节数;这些字节将通过 k-1] 存储在元素中,使元素 b[off+b[off+b[off]k]b[off+len-1]受影响。

在每种情况下,通过b[off-1]的元素b[0]和元素b[b.length-1]b[off+len]都不受影响。

read(b, off, len)InputStream的方法只是重复调用该方法read()。 如果第一个此类调用导致异常 IOException,则会从调用方法返回该 read(b,off,len) 异常。 如果任何后续调用 read() 导致异常 IOException,则会捕获异常并被视为文件末尾;读取到该点 b 的字节数以及异常发生前读取的字节数。 此方法的默认实现会阻止,直到读取请求的输入数据 len 量、检测到文件结束或引发异常为止。 鼓励子类提供此方法的更高效实现。

Java文档java.io.InputStream.read(byte[], int, int)

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

适用于