InputStream.Read 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
| 名称 | 说明 |
|---|---|
| Read() |
从输入流中读取下一字节的数据。 |
| Read(Byte[]) |
从输入流中读取一些字节并将其存储到缓冲区数组 |
| Read(Byte[], Int32, Int32) |
将数据从输入流读取到 |
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中的字节返回int。255 如果没有字节可用,因为已达到流的末尾,则返回该值 -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)。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。