语言

IScatteringByteChannel.Read 方法

定义

重载

名称 说明
Read(ByteBuffer[])

将此通道中的字节序列读入给定缓冲区。

Read(ByteBuffer[], Int32, Int32)

将此通道中的字节序列读入给定缓冲区的子序列。

Read(ByteBuffer[])

将此通道中的字节序列读入给定缓冲区。

[Android.Runtime.Register("read", "([Ljava/nio/ByteBuffer;)J", "GetRead_arrayLjava_nio_ByteBuffer_Handler:Java.Nio.Channels.IScatteringByteChannelInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public long Read(Java.Nio.ByteBuffer[]? dsts);
[<Android.Runtime.Register("read", "([Ljava/nio/ByteBuffer;)J", "GetRead_arrayLjava_nio_ByteBuffer_Handler:Java.Nio.Channels.IScatteringByteChannelInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member Read : Java.Nio.ByteBuffer[] -> int64

参数

dsts
ByteBuffer[]

要传输到的字节的缓冲区

返回

读取的字节数(可能为零)或 -1 通道是否已到达流端

属性

例外

如果通道在此读取操作期间由另一个线程关闭,

如果另一个线程在操作正在进行时中断调用线程, 已设置调用线程的中断状态,并且通道已关闭。

如果通道已关闭,则为 。

如果发生另一个 I/O 错误,则为详细信息位于消息中。

如果通道尚未在允许读取的模式下打开,

注解

将此通道中的字节序列读入给定缓冲区。

对窗体 c.read(dsts) 的此方法的调用的行为方式与调用方式完全相同

<blockquote>

c.read(dsts, 0, dsts.length);

</blockquote>

Java文档java.nio.channels.ScatteringByteChannel.read(java.nio.ByteBuffer[])。

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

适用于

Read(ByteBuffer[], Int32, Int32)

将此通道中的字节序列读入给定缓冲区的子序列。

[Android.Runtime.Register("read", "([Ljava/nio/ByteBuffer;II)J", "GetRead_arrayLjava_nio_ByteBuffer_IIHandler:Java.Nio.Channels.IScatteringByteChannelInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public long Read(Java.Nio.ByteBuffer[]? dsts, int offset, int length);
[<Android.Runtime.Register("read", "([Ljava/nio/ByteBuffer;II)J", "GetRead_arrayLjava_nio_ByteBuffer_IIHandler:Java.Nio.Channels.IScatteringByteChannelInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member Read : Java.Nio.ByteBuffer[] * int * int -> int64

参数

dsts
ByteBuffer[]

要传输到的字节的缓冲区

offset
Int32

要传输到的第一个缓冲区的缓冲区数组中的偏移量;必须为非负值且不大于 dsts.length

length
Int32

要访问的最大缓冲区数;必须为非负值且不大于 dsts.length - offset

返回

读取的字节数(可能为零)或 -1 通道是否已到达流端

属性

例外

如果通道在此读取操作期间由另一个线程关闭,

如果另一个线程在操作正在进行时中断调用线程, 已设置调用线程的中断状态,并且通道已关闭。

如果通道已关闭,则为 。

如果offset 或length 大于其大小offset + length,则buffers为

如果发生另一个 I/O 错误,则为详细信息位于消息中。

如果通道尚未在允许读取的模式下打开,

注解

将此通道中的字节序列读入给定缓冲区的子序列。

此方法的调用尝试从此通道读取最多 r 字节,其中 r 是给定缓冲区数组的指定子序列剩余的字节总数,即,

<blockquote>

dsts[offset].remaining()
                + dsts[offset+1].remaining()
                + ... + dsts[offset+length-1].remaining()

</blockquote>

在调用此方法时。

假设读取长度 n 的字节序列,其中 0 <= n <= r. 最多将此序列的第一 dsts[offset].remaining() 个字节传输到缓冲区 dsts[offset]中,直到整个字节序列传输到给定缓冲区,直到将下一 dsts[offset+1].remaining() 个字节传输到缓冲区 dsts[offset+1],依此类推。 将尽可能多的字节传输到每个缓冲区中,因此,每个更新缓冲区(上次更新的缓冲区除外)的最终位置保证等于该缓冲区的限制。

可以随时调用此方法。 但是,如果另一个线程已在此通道上启动读取操作,则此方法的调用将阻止,直到第一个操作完成。

Java文档java.nio.channels.ScatteringByteChannel.read(java.nio.ByteBuffer[], int, int)。

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

适用于