IReadableByteChannel.Read(ByteBuffer) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
このチャネルから特定のバッファーにバイトシーケンスを読み取ります。
[Android.Runtime.Register("read", "(Ljava/nio/ByteBuffer;)I", "GetRead_Ljava_nio_ByteBuffer_Handler:Java.Nio.Channels.IReadableByteChannelInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public int Read (Java.Nio.ByteBuffer? dst);
[<Android.Runtime.Register("read", "(Ljava/nio/ByteBuffer;)I", "GetRead_Ljava_nio_ByteBuffer_Handler:Java.Nio.Channels.IReadableByteChannelInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member Read : Java.Nio.ByteBuffer -> int
パラメーター
- dst
- ByteBuffer
バイトの転送先となるバッファー
戻り値
読み取られたバイト数(ゼロの可能性あり)、または -1
チャネルがストリームの終了に達した場合
- 属性
例外
読み取り中に別のスレッドがチャネルを閉じる場合は 。
操作の進行中に別のスレッドが呼び出し元のスレッドを中断した場合。 呼び出し元スレッドの割り込み状態が設定され、チャネルが閉じられます。
チャネルが閉じている場合は 。
別の I/O エラーが発生し、詳細がメッセージに表示されます。
チャネルが読み取り用に開かれていた場合は 。
注釈
このチャネルから特定のバッファーにバイトシーケンスを読み取ります。
チャネルから最大 r バイトまでの読み取りが試行されます。 ここで、r はバッファーに残っているバイト数 (つまり、 dst.remaining()
このメソッドが呼び出された時点) です。
長さ n のバイト シーケンスが読み取られたとします。ここで 0
、nbsp&;<=
nbsp を&します。n <=
r. このバイト シーケンスはバッファーに転送され、シーケンスの最初のバイトがインデックス p に、最後のバイトがインデックス p  になるように+
します。 n -
nbsp;1
&します。 ここで、p は、このメソッドが呼び出された時点でのバッファーの位置です。 戻り時に、バッファーの位置は p  と等しくなります。+
n;その制限は変更されません。
読み取り操作はバッファーを埋めず、実際にはバイトをまったく読み取らない可能性があります。 そうするかどうかは、チャネルの性質と状態によって異なります。 たとえば、非ブロッキング モードのソケット チャネルでは、ソケットの入力バッファーからすぐに使用できるバイト数を超えるバイトを読み取ることはできません。同様に、ファイル チャネルは、ファイルに残っているバイト数を超えるバイトを読み取ることはできません。 ただし、チャネルがブロック モードで、バッファーに少なくとも 1 バイトが残っている場合、このメソッドは少なくとも 1 バイトが読み取られるまでブロックすることが保証されます。
このメソッドは、いつでも呼び出すことができます。 ただし、別のスレッドがこのチャネルで既に読み取り操作を開始している場合、このメソッドの呼び出しは、最初の操作が完了するまでブロックされます。
の java.nio.channels.ReadableByteChannel.read(java.nio.ByteBuffer)
Java ドキュメント。
このページの一部は、によって作成および共有された作業に基づく変更であり、に記載されている条件に従って使用されます。