Buffer クラス

定義

[Android.Runtime.Register("java/nio/Buffer", DoNotGenerateAcw=true)]
public abstract class Buffer : Java.Lang.Object

[<Android.Runtime.Register("java/nio/Buffer", DoNotGenerateAcw=true)>]
type Buffer = class
    inherit Object

継承

Object

JavaObject

Object

Buffer

派生

Java.Nio.ByteBuffer

Java.Nio.CharBuffer

Java.Nio.DoubleBuffer

Java.Nio.FloatBuffer

Java.Nio.IntBuffer

その他…

属性

RegisterAttribute

注釈

特定のプリミティブ型のデータのコンテナー。

バッファーは、特定のプリミティブ型の要素の線形有限シーケンスです。 その内容とは別に、バッファーの重要なプロパティは、その容量、制限、位置です。

<blockquote>

バッファーの 容量 は、バッファーに含まれる要素の数です。 バッファーの容量は負の値になることがなく、変更されることもありません。

バッファーの 制限 は、読み取ったり書き込んだりしてはならない最初の要素のインデックスです。 バッファーの制限は負の値ではなく、容量を超えることはありません。

バッファーの 位置 は、読み取りまたは書き込みを行う次の要素のインデックスです。 バッファーの位置は負ではなく、その制限を超えることはありません。

</blockquote>

このクラスには、ブール以外のプリミティブ型ごとに 1 つのサブクラスがあります。

<h2> データ転送 </h2>

このクラスの各サブクラスは、get 操作と put 操作の 2 つのカテゴリを定義します。

<blockquote>

相対 操作では、現在の位置から始まる 1 つ以上の要素の読み取りまたは書き込みを行い、転送された要素の数だけ位置をインクリメントします。 要求された転送が制限を超えた場合、相対 取得 操作は BufferUnderflowException をスローし、相対 put 操作は BufferOverflowExceptionをスローします。いずれの場合も、データは転送されません。

絶対 操作は明示的な要素インデックスを受け取り、位置には影響しません。 絶対 取得 および 配置 操作では、インデックス引数が制限を超えた場合に IndexOutOfBoundsException がスローされます。

</blockquote>

データは、当然ながら、適切なチャネルの I/O 操作によってバッファーに転送されたり、バッファーから転送されたりする場合もあります。これは、常に現在の位置に対して相対的です。

<h2></h2 のマーキングとリセット>

バッファーの マーク は、 #reset reset メソッドが呼び出されたときに位置がリセットされるインデックスです。 マークは常に定義されるとは限りませんが、定義されている場合は負の値ではなく、位置よりも大きくはありません。 マークが定義されている場合、位置または制限がマークより小さい値に調整されると、マークは破棄されます。 マークが定義されていない場合、 #reset reset メソッドを呼び出すと、 InvalidMarkException がスローされます。

<h2> インバリアント </h2>

マーク、位置、制限、および容量の値に対して、次のインバリアント が保持されます。

<blockquote>0<=mark<=position<=limit<=capacity</blockquote>

新しく作成されたバッファーには、常に 0 の位置と未定義のマークがあります。 初期制限は 0 である場合もあれば、バッファーの型とバッファーの構築方法に依存する他の値である場合もあります。 新しく割り当てられたバッファーの各要素は 0 に初期化されます。

<h2> 追加操作 </h2>

このクラスは、位置、制限、容量の値にアクセスし、マーキングとリセットを行うメソッドに加えて、バッファーに対して次の操作も定義します。

<ul>

<li>

#clear では、チャネル読み取り操作または相対 put 操作の新しいシーケンスに対してバッファーの準備が整います。容量に制限を設定し、位置を 0 に設定します。

</li>

<li>

#flip では、チャネル書き込みまたは相対 取得 操作の新しいシーケンスに対してバッファーの準備が整います。制限を現在の位置に設定し、位置を 0 に設定します。

</li>

<li>

#rewind は、既に格納されているデータを再読み取りするバッファーを作成します。制限は変更されず、位置は 0 に設定されます。

</li>

<li>

#sliceメソッドと#slice(int,int) slice(index,length)メソッドは、バッファーのサブシーケンスを作成します。制限と位置は変更されません。

</li>

<li>

#duplicate はバッファーの浅いコピーを作成します。制限と位置は変更されません。

</li>

</ul>

<h2> 読み取り専用バッファー </h2>

すべてのバッファーは読み取り可能ですが、すべてのバッファーが書き込み可能なわけではありません。 各バッファー クラスの変更メソッドは、読み取り専用バッファーで呼び出されたときにをスローするReadOnlyBufferExceptionとして指定されます。 読み取り専用バッファーでは、コンテンツの変更は許可されませんが、マーク、位置、および制限値は変更可能です。 バッファーが読み取り専用かどうかは、 #isReadOnly isReadOnly メソッドを呼び出すことによって判断できます。

<h2> スレッド セーフ </h2>

バッファーは、複数の同時実行スレッドで使用しても安全ではありません。 バッファーを複数のスレッドで使用する場合は、バッファーへのアクセスを適切な同期によって制御する必要があります。

<h2> 呼び出しチェーン </h2>

それ以外の場合は返す値を持たないこのクラスのメソッドは、呼び出されるバッファーを返すように指定されます。 これにより、メソッド呼び出しをチェーンできます。たとえば、ステートメントのシーケンス

<blockquote>

b.flip();
            b.position(23);
            b.limit(42);

</blockquote>

は、単一の、よりコンパクトなステートメントに置き換えることができます

<blockquote>

b.flip().position(23).limit(42);

</blockquote>

1.4 で追加されました。

Javaドキュメント。

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