クラスFloatBuffer
- すべての実装されたインタフェース:
Comparable<FloatBuffer>
このクラスは、floatバッファに対する操作を4つのカテゴリに分類します。
連続する一連の浮動物をこのバッファから配列に転送する絶対および相対的な
bulk getメソッド浮動小数配列またはその他の浮動小数バッファからこのバッファに連続する浮動小数点のシーケンスを転送する絶対および相対的な
bulk putメソッド浮動小数点バッファを
compactingするためのメソッド。
floatバッファを作成するには、バッファの内容に容量を割り当てる割り当てを実行するか、既存のfloat配列をバッファ内にラップするか、既存のbyteバッファのビューを作成します。
byteバッファと同様に、floatバッファにも「ダイレクト」と「非ダイレクト」があります。 このクラスのwrapメソッドを介して作成された浮動小数点バッファは、非ダイレクトになります。 byteバッファのビューとして作成されたfloatバッファは、byteバッファがダイレクト・バッファである場合にかぎりダイレクト・バッファになります。 floatバッファがダイレクト・バッファかどうかは、isDirectメソッドの呼出しによって判断できます。
このクラスのメソッドのうち戻り値を返さないものは、自身を呼び出したバッファの情報を返します。 これを応用して、メソッド呼出しを連鎖させることができます。
オプションの操作
「オプションの操作」として指定されたメソッドは、read-only FloatBufferで呼び出されるとReadOnlyBufferExceptionをスローします。 FloatBufferが「アクセス可能なfloat配列」 (FloatBufferが読取り専用かどうかに関係なく、)に支えられていない場合、メソッド「配列」およびarrayOffsetはUnsupportedOperationExceptionをスローします。- 導入されたバージョン:
- 1.4
-
メソッドのサマリー
修飾子と型メソッド説明static FloatBufferallocate(int capacity) 新しいfloatバッファを割り当てます。final float[]array()このバッファを補助するfloat配列を返します (オプションの操作)。final intこのバッファの補助配列内にある、このバッファの最初の要素のオフセットを返します (オプションの操作)。abstract FloatBufferこのバッファの内容を共有する新しい読込み専用floatバッファを作成します。final FloatBufferclear()このバッファをクリアします。abstract FloatBuffercompact()このバッファを圧縮します (オプションの操作)。intcompareTo(FloatBuffer that) このバッファを別のバッファと比較します。abstract FloatBufferこのバッファの内容を共有する新しいfloatバッファを作成します。booleanこのバッファが別のオブジェクトと等価であるかどうかを判断します。final FloatBufferflip()このバッファをフリップ(反転)します。abstract floatget()相対getメソッドです。get(float[] dst) 相対一括getメソッドです。get(float[] dst, int offset, int length) 相対一括getメソッドです。abstract floatget(int index) 絶対getメソッドです。get(int index, float[] dst) 絶対一括getメソッド。get(int index, float[] dst, int offset, int length) 絶対一括getメソッド。final booleanhasArray()このバッファがアクセス可能なfloat配列に連動するかどうかを判断します。inthashCode()このバッファの現在のハッシュ・コードを返します。abstract booleanisDirect()現在のfloatバッファがダイレクト・バッファであるかどうかを判断します。final FloatBufferlimit(int newLimit) このバッファのリミットを設定します。final FloatBuffermark()このバッファの現在位置にマークを設定します。intmismatch(FloatBuffer that) このバッファと指定されたバッファの最初の不一致の相対索引を検索して戻します。abstract ByteOrderorder()このバッファのbyte順序を取得します。final FloatBufferposition(int newPosition) このバッファの位置を設定します。abstract FloatBufferput(float f) 相対putメソッドです (オプションの操作)。final FloatBufferput(float[] src) 相対一括putメソッドです (オプションの操作)。put(float[] src, int offset, int length) 相対一括putメソッドです (オプションの操作)。abstract FloatBufferput(int index, float f) 絶対putメソッドです (オプションの操作)。put(int index, float[] src) (optional operation)の絶対一括putメソッド。put(int index, float[] src, int offset, int length) (optional operation)の絶対一括putメソッド。put(int index, FloatBuffer src, int offset, int length) (optional operation)の絶対一括putメソッド。put(FloatBuffer src) 相対一括putメソッドです (オプションの操作)。final FloatBufferreset()バッファの位置を以前にマークした位置に戻します。final FloatBufferrewind()このバッファをリワインド(巻き戻し)します。abstract FloatBufferslice()このバッファの内容の共有サブシーケンスを内容とする新しいfloatバッファを作成します。abstract FloatBufferslice(int index, int length) このバッファの内容の共有サブシーケンスを内容とする新しいfloatバッファを作成します。toString()このバッファの状態を要約した文字列を返します。static FloatBufferwrap(float[] array) float配列をバッファにラップします。static FloatBufferwrap(float[] array, int offset, int length) float配列をバッファにラップします。クラスjava.nio.Bufferで宣言されたメソッド
capacity, hasRemaining, isReadOnly, limit, position, remaining
-
メソッドの詳細
-
allocate
public static FloatBuffer allocate(int capacity) 新しいfloatバッファを割り当てます。新しいバッファの位置はゼロ、その制限は容量、マークは未定義、各要素はゼロに初期化され、そのバイト順序は基礎となるハードウェアの
native orderになります。backing arrayがあり、そのarray offsetはゼロになります。- パラメータ:
capacity- 新しいバッファの容量(float)- 戻り値:
- 新しいfloatバッファ
- スロー:
IllegalArgumentException-capacityが負の整数である場合
-
wrap
public static FloatBuffer wrap(float[] array, int offset, int length) float配列をバッファにラップします。新しいバッファは指定されたfloat配列によって補助されます。バッファに変更を加えると配列も変更され、配列に変更を加えるとバッファも変更されます。 新しいバッファの容量は
array.length、位置はoffset、制限はoffset + length、マークは未定義、バイト順序は基礎となるハードウェアのnative orderになります。 そのbacking arrayは指定された配列になり、そのarray offsetはゼロになります。- パラメータ:
array- 新しいバッファを補助する配列offset- 使用するサブ配列のオフセット。負以外で、array.length以下である必要があります。 新しいバッファの位置は、この値に設定される。length- 使用するサブ配列の長さ。負以外で、array.length - offset以下である必要があります。 新しいバッファの制限はoffset + lengthに設定されます。- 戻り値:
- 新しいfloatバッファ
- スロー:
IndexOutOfBoundsException-offsetパラメータとlengthパラメータの前提条件が満たされていない場合
-
wrap
public static FloatBuffer wrap(float[] array) float配列をバッファにラップします。新しいバッファは指定されたfloat配列によって補助されます。バッファに変更を加えると配列も変更され、配列に変更を加えるとバッファも変更されます。 新しいバッファの容量と制限は
array.length、その位置はゼロ、マークは未定義、バイト順序は基礎となるハードウェアのnative orderになります。 そのbacking arrayは指定された配列になり、そのarray offsetはゼロになります。- パラメータ:
array- このバッファを補助する配列- 戻り値:
- 新しいfloatバッファ
-
slice
public abstract FloatBuffer slice()このバッファの内容の共有サブシーケンスを内容とする新しいfloatバッファを作成します。新しいバッファの内容は、このバッファの現在位置から始まります。 このバッファの内容に変更を加えると、その内容が新しいバッファに反映されます。新しいバッファの内容に変更を加えると、その内容がこのバッファに反映されます。2つのバッファの位置、リミット、マークの値はそれぞれ異なります。
新しいバッファの位置はゼロになり、その容量と制限はこのバッファに残っているフロートの数になり、マークは未定義になり、そのバイト順序はこのバッファのものと同じになります。 新しいバッファは、このバッファがダイレクト・バッファである場合にかぎりダイレクト・バッファになります。また、このバッファが読取り専用バッファである場合にかぎり読取り専用バッファになります。
-
slice
public abstract FloatBuffer slice(int index, int length) このバッファの内容の共有サブシーケンスを内容とする新しいfloatバッファを作成します。新しいバッファの内容は、このバッファ内の
indexの位置から始まり、length要素が含まれます。 このバッファの内容に変更を加えると、その内容が新しいバッファに反映されます。新しいバッファの内容に変更を加えると、その内容がこのバッファに反映されます。2つのバッファの位置、リミット、マークの値はそれぞれ異なります。新しいバッファ位置はゼロ、容量とリミットは
length、マークは未定義、バイト順序はこのバッファのものと同一です。 新しいバッファは、このバッファがダイレクト・バッファである場合にかぎりダイレクト・バッファになります。また、このバッファが読取り専用バッファである場合にかぎり読取り専用バッファになります。- 定義:
- クラス
Bufferのslice - パラメータ:
index- 新しいバッファの内容が開始される、このバッファ内の位置。limit()以外の値である必要があります。length- 新規バッファに含まれる要素の数。負以外でlimit() - indexより大きい値である必要があります。- 戻り値:
- 新しいバッファ
- スロー:
IndexOutOfBoundsException-indexが、limit()以上の場合、lengthがマイナスまたはlength > limit() - index- 導入されたバージョン:
- 13
-
duplicate
public abstract FloatBuffer duplicate()このバッファの内容を共有する新しいfloatバッファを作成します。新しいバッファの内容は、このバッファの内容と同じになります。 このバッファの内容に変更を加えると、その内容が新しいバッファに反映されます。新しいバッファの内容に変更を加えると、その内容がこのバッファに反映されます。2つのバッファの位置、リミット、マークの値はそれぞれ異なります。
新しいバッファの容量、制限、位置、マーク値、およびバイト順序は、このバッファの容量と同一になります。 新しいバッファは、このバッファがダイレクト・バッファである場合にかぎりダイレクト・バッファになります。また、このバッファが読取り専用バッファである場合にかぎり読取り専用バッファになります。
-
asReadOnlyBuffer
public abstract FloatBuffer asReadOnlyBuffer()このバッファの内容を共有する新しい読込み専用floatバッファを作成します。新しいバッファの内容は、このバッファの内容と同じになります。 このバッファの内容に変更を加えると、その内容が新しいバッファに反映されます。しかし、新しいバッファ自体は読取り専用であり、その共有内容を変更することはできません。 2つのバッファの位置、リミット、マークの値はそれぞれ異なります。
新しいバッファの容量、制限、位置、マーク値、およびバイト順序は、このバッファの容量と同一になります。
このバッファ自身が読込み専用の場合は、このメソッドは
duplicateと同じように動作します。- 戻り値:
- 新しい読込み専用floatバッファ
-
get
public abstract float get()相対getメソッドです。 バッファの現在位置にあるfloatを読み込み、現在位置の値を増加します。- 戻り値:
- バッファの現在位置のfloat
- スロー:
BufferUnderflowException- バッファの現在位置がリミット以上である場合
-
put
public abstract FloatBuffer put(float f) 相対putメソッドです (オプションの操作)。このバッファの現在位置に指定されたfloatを書き込み、現在位置を増加します。
- パラメータ:
f- 書き込まれるfloat- 戻り値:
- このバッファ
- スロー:
BufferOverflowException- このバッファの現在位置がリミット以上である場合ReadOnlyBufferException- このバッファが読込み専用である場合
-
get
public abstract float get(int index) 絶対getメソッドです。 指定されたインデックス位置のfloatを読み込みます。- パラメータ:
index- floatの読込み位置を示すインデックス- 戻り値:
- 指定されたインデックス位置のfloat
- スロー:
IndexOutOfBoundsException-indexが負の値であるか、バッファの制限より小さい値でない場合
-
put
public abstract FloatBuffer put(int index, float f) 絶対putメソッドです (オプションの操作)。このバッファの指定されたインデックス位置に、指定されたfloatを書き込みます。
- パラメータ:
index- floatの書込み先を示すインデックスf- 書き込まれるfloat値- 戻り値:
- このバッファ
- スロー:
IndexOutOfBoundsException-indexが負の値であるか、バッファの制限より小さい値でない場合ReadOnlyBufferException- このバッファが読込み専用である場合
-
get
public FloatBuffer get(float[] dst, int offset, int length) 相対一括getメソッドです。このメソッドは、このバッファから指定された配列へfloatを転送します。 バッファに残っているフロートが、リクエストを満たすために必要となるフロートより少ない場合、つまり、
length>remaining()の場合、フロートは転送されず、BufferUnderflowExceptionがスローされます。それ以外の場合、このメソッドは、
lengthフロートをこのバッファから指定された配列にコピーし、このバッファの現在の位置と配列内の指定されたオフセットから開始します。 このバッファの位置は、lengthによって増分されます。つまり、
src.get(dst, off, len)形式のこのメソッドの呼出しは、ループとまったく同じ効果がありますただし、このバッファ内に十分な数のfloatが存在することを最初に確認する動作は除きます。また、このメソッドを使用したほうがループよりもはるかに効率的です。for (int i = off; i < off + len; i++) dst[i] = src.get();- パラメータ:
dst- floatの書込み先となる配列offset- 書き込まれる最初の浮動小数点の配列内のオフセット。負以外で、dst.length以下である必要がありますlength- 指定された配列に書き込まれる最大フロート数。負以外で、dst.length - offset以下である必要があります- 戻り値:
- このバッファ
- スロー:
BufferUnderflowException- このバッファに残っているフロートがlengthより少ない場合IndexOutOfBoundsException-offsetパラメータとlengthパラメータの前提条件が満たされていない場合
-
get
public FloatBuffer get(float[] dst) 相対一括getメソッドです。このメソッドは、このバッファから指定された配列へfloatを転送します。
src.get(a)形式のこのメソッドの起動は、起動とまったく同じように動作src.get(a, 0, a.length)- パラメータ:
dst- コピー先配列- 戻り値:
- このバッファ
- スロー:
BufferUnderflowException- このバッファに残っているフロートがlengthより少ない場合
-
get
public FloatBuffer get(int index, float[] dst, int offset, int length) 絶対一括getメソッド。このメソッドは、このバッファ内の指定されたインデックスから、配列内の指定されたオフセットから開始して、
lengthfloatをこのバッファから指定された配列に転送します。 このバッファの位置は変わりません。フォーム
src.get(index, dst, offset, length)のこのメソッドを起動しても、次のループとまったく同じ効果があります。ただし、最初に提供されたパラメータの一貫性がチェックされ、それがさらに効率的である可能性があります:for (int i = offset, j = index; i < offset + length; i++, j++) dst[i] = src.get(j);- パラメータ:
index- 最初の浮動小数の読取り元であるこのバッファ内のインデックス。負でない、およびlimit()より小さい必要がありますdst- コピー先配列offset- 最初に書き込まれる浮動小数の配列内のオフセット。dst.length以外の値である必要があります。length- 指定された配列に書き込まれるfloatの数。負でない値でなければならず、limit() - indexやdst.length - offsetの値より小さくてはいけません。- 戻り値:
- このバッファ
- スロー:
IndexOutOfBoundsException-index、offsetおよびlengthパラメータの事前条件が満たされていない場合、それらを保持しません- 導入されたバージョン:
- 13
-
get
public FloatBuffer get(int index, float[] dst) 絶対一括getメソッド。このメソッドは、このバッファから指定された配列へfloatを転送します。 このバッファの位置は変わりません。 フォーム
src.get(index, dst)のこのメソッドの起動は、起動とまったく同じ方法で動作します:src.get(index, dst, 0, dst.length)- パラメータ:
index- 最初の浮動小数の読取り元であるこのバッファ内のインデックス。負でない、およびlimit()より小さい必要がありますdst- コピー先配列- 戻り値:
- このバッファ
- スロー:
IndexOutOfBoundsException-indexが負であるか、limit()より小さくないか、またはlimit() - index < dst.lengthの場合- 導入されたバージョン:
- 13
-
put
public FloatBuffer put(FloatBuffer src) 相対一括putメソッドです (オプションの操作)。このメソッドは、指定されたソース・バッファ内に残っているfloatをこのバッファへ転送します。 ソース・バッファに、このバッファよりも多くのフロートが残っている場合、つまり、
src.remaining()>remaining()の場合、フロートは転送されず、BufferOverflowExceptionがスローされます。それ以外の場合、このメソッドは、指定されたバッファのn =
src.remaining()floatsを、各バッファの現在の位置からこのバッファにコピーします。 そのたびに、両方のバッファの位置がnずつ増加します。つまり、
dst.put(src)形式のこのメソッドの呼出しは、ループとまったく同じ効果がありますただし、このバッファ内に十分な容量があることを最初に確認する動作は除きます。また、このメソッドを使用したほうがループよりもはるかに効率的です。 このバッファとソース・バッファが同じバッキング配列またはメモリーを共有している場合、結果は、このバッファに書き込まれる前にソース要素が最初に中間のロケーションにコピーされたかのようになります。while (src.hasRemaining()) dst.put(src.get());- パラメータ:
src- floatの読込み先となるソース・バッファ(このバッファ以外)- 戻り値:
- このバッファ
- スロー:
BufferOverflowException- このバッファに、ソース・バッファ内に残っているfloatを格納できるだけの容量がない場合IllegalArgumentException- ソース・バッファとしてこのバッファを指定した場合ReadOnlyBufferException- このバッファが読込み専用である場合
-
put
public FloatBuffer put(int index, FloatBuffer src, int offset, int length) (optional operation)の絶対一括putメソッド。このメソッドは、ソース・バッファ内の指定された
offsetおよびこのバッファ内の指定されたindexからlengthfloatをこのバッファに転送します。 両方のバッファの位置は変更されません。つまり、
dst.put(index, src, offset, length)形式のこのメソッドの呼出しは、ループとまったく同じ効果があります最初に、指定されたパラメータの一貫性をチェックし、より効率的になる可能性があることを除きます。 このバッファとソース・バッファが同じバッキング配列またはメモリーを共有している場合、結果は、このバッファに書き込まれる前にソース要素が最初に中間のロケーションにコピーされたかのようになります。for (int i = offset, j = index; i < offset + length; i++, j++) dst.put(j, src.get(i));- パラメータ:
index- 最初の浮動小数が書き込まれるこのバッファ内のインデックス。負でない、およびlimit()より小さい必要がありますsrc- floatの読取り元バッファoffset- 読み込まれる最初のfloatのソース・バッファ内のインデックス。負ではなく、src.limit()より小さい値である必要がありますlength- 指定されたバッファから読み取られるfloatの数。limit() - indexおよびsrc.limit() - offsetのいずれか小さい方より小さく、負でない値にする必要があります- 戻り値:
- このバッファ
- スロー:
IndexOutOfBoundsException-index、offsetおよびlengthパラメータの事前条件が満たされていない場合、それらを保持しませんReadOnlyBufferException- このバッファが読込み専用である場合- 導入されたバージョン:
- 16
-
put
public FloatBuffer put(float[] src, int offset, int length) 相対一括putメソッドです (オプションの操作)。このメソッドは、指定されたソース配列からこのバッファへfloatを転送します。 配列からコピーされるフロートが、このバッファに残らない場合、つまり、
length>remaining()の場合、フロートは転送されず、BufferOverflowExceptionがスローされます。それ以外の場合、このメソッドは、指定された配列からこのバッファに
lengthフロートをコピーします。このバッファは、配列内の指定されたオフセットから、このバッファの現在の位置で始まります。 このバッファの位置は、lengthによって増分されます。つまり、
dst.put(src, off, len)形式のこのメソッドの呼出しは、ループとまったく同じ効果がありますただし、このバッファ内に十分な容量があることを最初に確認する動作は除きます。また、このメソッドを使用したほうがループよりもはるかに効率的です。for (int i = off; i < off + len; i++) dst.put(src[i]);- パラメータ:
src- floatの読込み先となる配列offset- 最初に読み込まれる浮動小数の配列内のオフセット。src.lengthより小さくない、または大きくないでくださいlength- 指定された配列から読み取られるfloatの数。負以外で、src.length - offset以外の値である必要があります。- 戻り値:
- このバッファ
- スロー:
BufferOverflowException- このバッファ内に残っている容量が不足している場合IndexOutOfBoundsException-offsetパラメータとlengthパラメータの前提条件が満たされていない場合ReadOnlyBufferException- このバッファが読込み専用である場合
-
put
public final FloatBuffer put(float[] src) 相対一括putメソッドです (オプションの操作)。このメソッドは、ソースとなる指定されたfloat配列の内容全体をこのバッファへ転送します。
dst.put(a)形式のこのメソッドの起動は、起動とまったく同じように動作dst.put(a, 0, a.length)- パラメータ:
src- 転送元配列- 戻り値:
- このバッファ
- スロー:
BufferOverflowException- このバッファ内に残っている容量が不足している場合ReadOnlyBufferException- このバッファが読込み専用である場合
-
put
public FloatBuffer put(int index, float[] src, int offset, int length) (optional operation)の絶対一括putメソッド。このメソッドは、指定された配列から
lengthfloatを転送します。これは配列内の指定されたオフセットから開始し、このバッファ内の指定されたインデックスから開始します。 このバッファの位置は変わりません。フォーム
dst.put(index, src, offset, length)のこのメソッドを起動しても、次のループとまったく同じ効果があります。ただし、最初に提供されたパラメータの一貫性がチェックされ、それがさらに効率的である可能性があります:for (int i = offset, j = index; i < offset + length; i++, j++) dst.put(j, src[i]);- パラメータ:
index- 最初の浮動小数が書き込まれるこのバッファ内のインデックス。負でない、およびlimit()より小さい必要がありますsrc- floatの読込み先となる配列offset- 最初に読み込まれる浮動小数の配列内のオフセット。src.lengthより短く、小さくする必要があります。length- 指定された配列から読み取られるfloatの数。負でない値で、limit() - indexおよびsrc.length - offsetの値より小さくない値である必要があります。- 戻り値:
- このバッファ
- スロー:
IndexOutOfBoundsException-index、offsetおよびlengthパラメータの事前条件が満たされていない場合、それらを保持しませんReadOnlyBufferException- このバッファが読込み専用である場合- 導入されたバージョン:
- 13
-
put
public FloatBuffer put(int index, float[] src) (optional operation)の絶対一括putメソッド。このメソッドは、指定されたソース配列からこのバッファにfloatをコピーします。 このバッファの位置は変わりません。 フォーム
dst.put(index, src)のこのメソッドの起動は、起動とまったく同じ方法で動作します:dst.put(index, src, 0, src.length);- パラメータ:
index- 最初の浮動小数が書き込まれるこのバッファ内のインデックス。負でない、およびlimit()より小さい必要がありますsrc- floatの読込み先となる配列- 戻り値:
- このバッファ
- スロー:
IndexOutOfBoundsException-indexが負であるか、limit()より小さくないか、またはlimit() - index < src.lengthの場合ReadOnlyBufferException- このバッファが読込み専用である場合- 導入されたバージョン:
- 13
-
hasArray
public final boolean hasArray()このバッファがアクセス可能なfloat配列に連動するかどうかを判断します。このメソッドが
trueを返す場合、arrayおよびarrayOffsetメソッドを安全に起動できます。 -
array
public final float[] array()このバッファを補助するfloat配列を返します (オプションの操作)。このバッファの内容に変更を加えると、返される配列の内容も変更されます。その逆も同様です。
このメソッドを呼び出す前に
hasArrayメソッドを呼び出し、このバッファがアクセス可能な補助配列を持っていることを確認します。- 定義:
array、クラスBuffer- 戻り値:
- このバッファを補助する配列
- スロー:
ReadOnlyBufferException- このバッファが配列に連動しており、しかも読込み専用である場合UnsupportedOperationException- このバッファがアクセス可能な配列を利用しない場合
-
arrayOffset
public final int arrayOffset()このバッファの補助配列内にある、このバッファの最初の要素のオフセットを返します (オプションの操作)。このバッファが配列によってバックアップされる場合、バッファ位置pは配列索引p +
arrayOffset()に対応します。このメソッドを呼び出す前に
hasArrayメソッドを呼び出し、このバッファがアクセス可能な補助配列を持っていることを確認します。- 定義:
arrayOffset、クラスBuffer- 戻り値:
- このバッファの配列内にある、このバッファの最初の要素のオフセット
- スロー:
ReadOnlyBufferException- このバッファが配列に連動しており、しかも読込み専用である場合UnsupportedOperationException- このバッファがアクセス可能な配列を利用しない場合
-
position
public final FloatBuffer position(int newPosition) このバッファの位置を設定します。 新しい位置の値よりもマークの値のほうが大きい場合、マークの定義は破棄されます。 -
limit
public final FloatBuffer limit(int newLimit) このバッファのリミットを設定します。 位置の値が新しいリミットより大きい場合、リミットと同じ値に変更されます。 マークの値が新しいリミットより大きい場合、マークの定義は破棄されます。 -
mark
public final FloatBuffer mark()このバッファの現在位置にマークを設定します。 -
reset
public final FloatBuffer reset()バッファの位置を以前にマークした位置に戻します。このメソッドを呼び出しても、マークの値は変更されません。マークが破棄されることもありません。
-
clear
public final FloatBuffer clear()このバッファをクリアします。 バッファの位置はゼロ、リミットは容量の値に設定されます。マークは破棄されます。一連のチャネル読込み操作または「put」操作を使用してこのバッファにデータを格納する前に、このメソッドを呼び出します。 たとえば、
buf.clear(); // Prepare buffer for reading in.read(buf); // Read dataこのメソッドはバッファ内のデータを実際に消去するわけではありません。しかし、そうした状況で使用されるため、クリアと命名されています。
-
flip
public final FloatBuffer flip()このバッファをフリップ(反転)します。 リミットは現在位置の値に設定され、現在位置を表す値はゼロに設定されます。 マークが定義されている場合、そのマークは破棄されます。一連のチャネル読込み操作(put)のあと、このメソッドを呼び出してチャネル書込み操作(相対「get」)の準備を行います。 たとえば、
buf.put(magic); // Prepend header in.read(buf); // Read data into rest of buffer buf.flip(); // Flip buffer out.write(buf); // Write header + data to channelある場所から別の場所にデータを転送する際、このメソッドを
compactメソッドと組み合わせて使用することがあります。 -
rewind
public final FloatBuffer rewind()このバッファをリワインド(巻き戻し)します。 位置はゼロに設定され、マークは破棄されます。このメソッドは、リミットを正しく設定したあと、一連のチャネル書込み操作(get)の前に呼び出します。 たとえば、
out.write(buf); // Write remaining data buf.rewind(); // Rewind buffer buf.get(array); // Copy data into array -
compact
public abstract FloatBuffer compact()このバッファを圧縮します (オプションの操作)。バッファの現在位置からリミットまでの間にfloatが存在する場合、これらをバッファの先頭にコピーします。 つまり、索引p =
position()の浮動小数点が索引0にコピーされ、索引p + 1の浮動小数点が索引1にコピーされるため、索引limit()の浮動小数点までコピーされます-1が索引n =limit()にコピーされます-1-p. 最終的にバッファの位置はn+1に設定され、リミットは容量の値と等しくなります。 マークは破棄されます。バッファの位置は、ゼロではなく、コピーされるfloatの数と等しくなります。したがって、このメソッドを呼び出したあと、すぐに別の相対「put」メソッドを呼び出すことができます。
- 戻り値:
- このバッファ
- スロー:
ReadOnlyBufferException- このバッファが読込み専用である場合
-
isDirect
-
toString
-
hashCode
-
equals
public boolean equals(Object ob) このバッファが別のオブジェクトと等価であるかどうかを判断します。2つのfloatバッファは、次の場合にかぎり等価です。
要素の型が同じである
バッファ内に残っている要素数が同じである
バッファ内に残っている要素のシーケンス(開始位置とは無関係)が各点で等しい(pointwise equal)
(a == b)||(Float.isNaN(a)&& Float.isNaN(b))の場合、このメソッドでは2つのfloat要素aとbは等価とみなされます。Float.equals(Object)とは異なり、値-0.0と+0.0は等価とみなされます。
floatバッファが、その他の型のオブジェクトと等価になることはありません。
-
compareTo
public int compareTo(FloatBuffer that) このバッファを別のバッファと比較します。2つのfloatバッファを比較する際は、バッファ内に残っている要素のシーケンスが辞書順に比較されます。このとき、双方のバッファ内に残っているシーケンスの開始位置は考慮されません。
float要素のペアは、Float.compare(float,float)を呼び出すことによって比較されます。ただし、-0.0と0.0は等価と見なされます。 このメソッドでは、Float.NaNは自身に等しく、ほかのすべてのfloat値(Float.POSITIVE_INFINITYを含む)よりも大きいとみなされる。floatバッファとその他の型のオブジェクトを比較することはできません。
- 定義:
compareTo、インタフェースComparable<FloatBuffer>- パラメータ:
that- 比較対象のオブジェクト。- 戻り値:
- このバッファが指定されたバッファより小さい場合は負の整数、等しい場合はゼロ、大きい場合は正の整数
-
mismatch
public int mismatch(FloatBuffer that) このバッファと指定されたバッファの最初の不一致の相対索引を検索して戻します。 インデックスは各バッファのpositionに相対的であり、0 (包含)から各バッファのremainingの要素(除外)まで範囲になります。2つのバッファが共通プレフィクスを共有している場合、戻される索引は共通プレフィクスの長さとなり、各バッファ内のその索引の2つのバッファ間に不一致があることに従います。 一方のバッファがもう一方のバッファのプレフィクスである場合、戻された索引は各バッファ内の残りの要素の小さい方になり、残りの要素の数が多いバッファに対してのみ索引が有効になります。 それ以外の場合は、不一致はありません。
- パラメータ:
that- このバッファと不一致をテストするためのバイト・バッファ- 戻り値:
- このバッファと指定されたバッファの最初の不一致の相対索引です。一致しない場合は -1です。
- 導入されたバージョン:
- 11
-
order
public abstract ByteOrder order()このバッファのbyte順序を取得します。割当てまたは既存の
float配列のラップによって作成される浮動小数バッファのバイト順序は、基礎となるハードウェアのnative orderです。 byteバッファのビューとして作成されたfloatバッファのbyte順序は、ビューを作成した時点のbyteバッファのbyte順序と同じになります。- 戻り値:
- このバッファのbyte順序
-