语言

IGatheringByteChannel.Write 方法

定义

重载

名称 说明
Write(ByteBuffer[])

从给定缓冲区将字节序列写入此通道。

Write(ByteBuffer[], Int32, Int32)

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

Write(ByteBuffer[])

从给定缓冲区将字节序列写入此通道。

[Android.Runtime.Register("write", "([Ljava/nio/ByteBuffer;)J", "GetWrite_arrayLjava_nio_ByteBuffer_Handler:Java.Nio.Channels.IGatheringByteChannelInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public long Write(Java.Nio.ByteBuffer[]? srcs);
[<Android.Runtime.Register("write", "([Ljava/nio/ByteBuffer;)J", "GetWrite_arrayLjava_nio_ByteBuffer_Handler:Java.Nio.Channels.IGatheringByteChannelInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member Write : Java.Nio.ByteBuffer[] -> int64

参数

srcs
ByteBuffer[]

要从中检索字节的缓冲区

返回

写入的字节数,可能为零

属性

例外

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

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

如果通道已关闭,则为 。

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

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

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

注解

从给定缓冲区将字节序列写入此通道。

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

<blockquote>

c.write(srcs, 0, srcs.length);

</blockquote>

Java文档java.nio.channels.GatheringByteChannel.write(java.nio.ByteBuffer[])。

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于

Write(ByteBuffer[], Int32, Int32)

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

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

参数

srcs
ByteBuffer[]

要从中检索字节的缓冲区

offset
Int32

要从中检索字节的第一个缓冲区的缓冲区数组中的偏移量;必须为非负值且不大于 srcs.length

length
Int32

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

返回

写入的字节数,可能为零

属性

例外

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

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

如果通道已关闭,则为 。

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

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

如果通道未打开进行写入,则为 。

注解

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

尝试将最多 r 字节写入此通道,其中 r 是给定缓冲区数组的指定子序列中剩余的字节总数,即

<blockquote>

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

</blockquote>

在调用此方法时。

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

除非另有指定,否则写入操作仅在写入所有 r 请求的字节后返回。 某些类型的通道(具体取决于其状态)可能只写入某些字节或根本不写入任何字节。 例如,非阻塞模式下的套接字通道无法写入比套接字的输出缓冲区中可用更多的字节。

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

Java文档java.nio.channels.GatheringByteChannel.write(java.nio.ByteBuffer[], int, int)。

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于