Language

InputStream.Read メソッド

定義

オーバーロード

名前 説明
Read(Byte[], Int32, Int32)

入力ストリームから最大 len バイトのデータをバイト配列に読み取ります。

Read()

入力ストリームから次のバイトのデータを読み取ります。

Read(Byte[])

入力ストリームからバイト数を読み取り、バッファー配列 bに格納します。

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 が読み取られるか、ファイルの終わりが検出されるか、例外がスローされるまでブロックされます。 サブクラスは、このメソッドのより効率的な実装を提供することをお勧めします。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象

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 値が返されます。 このメソッドは、入力データが使用可能か、ストリームの末尾が検出されるか、例外がスローされるまでブロックします。

サブクラスは、このメソッドの実装を提供する必要があります。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象

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) }

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象