InputStream.Read メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| 名前 | 説明 |
|---|---|
| Read(Byte[], Int32, Int32) |
入力ストリームから最大 |
| Read() |
入力ストリームから次のバイトのデータを読み取ります。 |
| 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 の場合、バイトは読み取られず、0が返されます。それ以外の場合は、少なくとも 1 バイトの読み取りが試行されます。 ストリームがファイルの末尾にあるためにバイトが使用できない場合は、 -1 値が返されます。それ以外の場合は、少なくとも 1 バイトが読み取られ、 bに格納されます。
最初のバイト読み取りは要素 b[off]に格納され、次のバイトは b[off+1]に格納されます。 読み取られたバイト数は、最大で lenと同じです。
k を実際に読み取ったバイト数にします。これらのバイトは、b[off]b[off+ を介して-1]要素に格納され、要素b[off+k]b[off+len-1]影響を受けません。
どの場合も、要素がb[0]を介してb[off-1]され、要素b[off+len]b[b.length-1]は影響を受けません。
クラス read(b, off, len)のInputStream メソッドは、メソッドread()を繰り返し呼び出すだけです。 このような最初の呼び出しで IOExceptionが発生した場合、その例外は read(b,off,len) メソッドの呼び出しから返されます。 後続の read() 呼び出しで IOExceptionが発生した場合、例外がキャッチされ、ファイルの末尾であるかのように処理されます。その時点まで読み取られたバイトは b に格納され、例外が発生する前に読み取られたバイト数が返されます。 このメソッドの既定の実装では、要求された量の入力データ 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 が発生した場合。
注釈
入力ストリームから次のバイトのデータを読み取ります。 値バイトは、intに0範囲内の255として返されます。 ストリームの末尾に達したためにバイトが使用できない場合は、 -1 値が返されます。 このメソッドは、入力データが使用可能か、ストリームの末尾が検出されるか、例外がスローされるまでブロックします。
サブクラスは、このメソッドの実装を提供する必要があります。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
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 の場合、バイトは読み取られず、0が返されます。それ以外の場合は、少なくとも 1 バイトを読み取ろうとします。 ストリームがファイルの末尾にあるためにバイトが使用できない場合は、 -1 値が返されます。それ以外の場合は、少なくとも 1 バイトが読み取られ、 bに格納されます。
最初のバイト読み取りは要素 b[0]に格納され、次のバイトは b[1]に格納されます。 読み取られたバイト数は、最大で bの長さと同じです。
k を実際に読み取ったバイト数にします。これらのバイトは、b[0]b[ を介して-1]要素に格納され、要素b[k]b[b.length-1]影響を受けません。
クラス read(b)のInputStream メソッドの効果は、次と同じです。
{@code read(b, 0, b.length) }
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。