ByteBuffer クラス

定義

[Android.Runtime.Register("java/nio/ByteBuffer", DoNotGenerateAcw=true)]
public abstract class ByteBuffer : Java.Nio.Buffer, IDisposable, Java.Interop.IJavaPeerable, Java.Lang.IComparable

[<Android.Runtime.Register("java/nio/ByteBuffer", DoNotGenerateAcw=true)>]
type ByteBuffer = class
    inherit Buffer
    interface IComparable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

継承

Object

Object

Buffer

ByteBuffer

派生

Java.Nio.MappedByteBuffer

属性

RegisterAttribute

実装

IJavaObject IJavaPeerable IComparable IDisposable

注釈

バイト バッファー。

このクラスは、バイト バッファーに対する 6 つのカテゴリの操作を定義します。

<ul>

<李>

1 バイトの読み取りと#put(byte) <i>put</i>書き込みを行う絶対および相対#get() <i>get</i>メソッド。

</李>

<李>

このバッファーから配列に連続したバイト シーケンスを転送する相対 #get(byte[]) <i>bulk get</i> メソッド。

</李>

<李>

バイト配列またはその他のバイト バッファーからこのバッファーに連続するバイト シーケンスを転送する相対 #put(byte[]) <i>bulk put</i> メソッド。

</李>

<李>

他のプリミティブ型の値を読み取りおよび書き込み、特定のバイト順のバイト シーケンスとの間で変換する絶対および相対#getChar() <i>get</i>#putChar(char) <i>put</i>メソッド。

</李>

<李>

ビュー バッファーを作成するためのメソッド。バイト バッファーを、他のプリミティブ型の値を含むバッファーとして表示できます。

</李>

<李>

#compact compacting、#duplicate duplicating、および#slice slicingバイト バッファーのメソッド。

</李>

</ul>

バイト バッファーは、バッファーの領域を割り当てるいずれかの方法で #allocate <i>allocation</i>作成できます。

コンテンツ、または既存のバイト配列によって #wrap(byte[]) <i>wrapping</i> バッファーに格納されます。

"direct"><h2> Direct vs. non-direct buffers </h2>

バイト バッファーは、直接または非ダイレクトのいずれかです。 直接バイト バッファーを指定すると、Java 仮想マシンはネイティブ I/O 操作を直接実行するためのベスト エフォートを行います。 つまり、基になるオペレーティング システムのネイティブ I/O 操作の各呼び出しの前 (または後) に、バッファーの内容を中間バッファーにコピーしないようにします。

直接バイト バッファーは、このクラスのファクトリ メソッドを #allocateDirect(int) allocateDirect 呼び出すことによって作成できます。 通常、このメソッドによって返されるバッファーは、非直接バッファーよりも割り当てコストと割り当て解除コストがやや高くなります。 ダイレクト バッファーの内容は、通常のガベージ コレクション ヒープの外部に存在する可能性があるため、アプリケーションのメモリ占有領域への影響は明らかではない可能性があります。 そのため、基になるシステムのネイティブ I/O 操作の対象となる有効期間の長い大規模なバッファーには、主に直接バッファーを割り当てることをお勧めします。 一般に、ダイレクト バッファーを割り当てるのは、プログラムのパフォーマンスが測定可能な向上をもたらす場合にのみ行うのが最善です。

直接バイト バッファーは、ファイルの領域によって java.nio.channels.FileChannel#map mapping メモリに直接作成される場合もあります。 Java プラットフォームの実装では、必要に応じて、JNI を介したネイティブ コードからの直接バイト バッファーの作成をサポートできます。 これらの種類のバッファーのいずれかのインスタンスがアクセスできないメモリ領域を参照している場合、その領域にアクセスしようとしてもバッファーの内容は変更されず、アクセス時または後で指定されていない例外がスローされます。

バイト バッファーがダイレクトバッファーか非ダイレクトバッファーかは、その #isDirect isDirect メソッドを呼び出すことによって決定できます。 このメソッドは、パフォーマンスクリティカルなコードで明示的なバッファー管理を実行できるように提供されています。

"bin"><h2> バイナリ データ <へのアクセス /h2>

このクラスは、他のすべてのプリミティブ型の値を読み書きするためのメソッドを定義します。ただし boolean、 プリミティブ値は、バッファーの現在のバイト順序に従ってバイトシーケンスに変換されます。これは、メソッドを介して #order order 取得および変更できます。 特定のバイトオーダーは、クラスの ByteOrder インスタンスによって表されます。 バイト バッファーの最初の順序は常に ByteOrder#BIG_ENDIAN BIG_ENDIANです。

異種バイナリ データ (つまり、異なる型の値のシーケンス) にアクセスするために、このクラスは、各型の絶対メソッドと相対 get メソッドと put メソッドのファミリを定義します。 たとえば、32 ビット浮動小数点値の場合、このクラスは次を定義します。

<blockquote>

float  {@link #getFloat()}
            float  {@link #getFloat(int) getFloat(int index)}
             void  {@link #putFloat(float) putFloat(float f)}
             void  {@link #putFloat(int,float) putFloat(int index, float f)}

</blockquote>

対応するメソッドは、型char、short、intlongおよび double. 絶対 get メソッドと put メソッドのインデックス パラメーターは、読み取りまたは書き込み中の型ではなくバイト単位です。

"views">

同種のバイナリ データ (つまり、同じ型の値のシーケンス) にアクセスするために、このクラスは、特定のバイト バッファーのビューを作成できるメソッドを定義します。 ビュー バッファーは、コンテンツがバイト バッファーによってサポートされる単なる別のバッファーです。 バイト バッファーの内容への変更はビュー バッファーに表示され、その逆も同様です。2 つのバッファーの位置、制限、およびマークの値は独立しています。 たとえば、このメソッドは #asFloatBuffer() asFloatBuffer 、メソッドが FloatBuffer 呼び出されるバイト バッファーによってサポートされるクラスのインスタンスを作成します。 対応するビュー作成メソッドは、型 char、 short、、 int、 longおよび double.

ビュー バッファーには、前述の型固有 の get メソッドと put メソッドのファミリに比べる 3 つの重要な利点があります。

<ul>

<李>

ビュー バッファーは、バイトではなく、その値の型固有のサイズの観点からインデックスが作成されます。

</李>

<李>

ビュー バッファーは、バッファーと配列、または同じ型の他のバッファーとの間で連続した値シーケンスを転送できる相対一括取得メソッドと put メソッドを提供します。

</李>

<李>

ビュー バッファーは、バッキング バイト バッファーが直接の場合にのみダイレクトになるため、はるかに効率的になる可能性があります。

</李>

</ul>

ビュー バッファーのバイト順は、ビューの作成時のバイト バッファーのバイト 順に固定されます。

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

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

ステートメントのシーケンス

<blockquote>

bb.putInt(0xCAFEBABE);
            bb.putShort(3);
            bb.putShort(45);

</blockquote>

たとえば、単一ステートメントに置き換えることができます

<blockquote>

bb.putInt(0xCAFEBABE).putShort(3).putShort(45);

</blockquote>

1.4 で追加されました。

の Java ドキュメントjava.nio.ByteBuffer

このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。

コンストラクター

プロパティ

メソッド

明示的なインターフェイスの実装

拡張メソッド

適用対象