モジュール java.base
パッケージ java.nio

クラスDoubleBuffer

java.lang.Object
java.nio.Buffer
java.nio.DoubleBuffer
すべての実装されたインタフェース:
Comparable<DoubleBuffer>
public abstract class DoubleBuffer extends Buffer implements Comparable<DoubleBuffer>
doubleバッファです。

このクラスは、doubleバッファに対する操作を4つのカテゴリに分類します。

  • 単一doubleの読み込みと書込みを行う絶対および相対get/putメソッド。

  • このバッファから配列に連続した連続するシーケンスを転送する絶対および相対bulk getメソッド; および

  • double配列{#if[char]?, a string,}またはその他のdoubleバッファからこのバッファに連続するdoubleのシーケンスを転送する絶対および相対bulk putメソッド。{#if [!byte]?および}

  • ダブル・バッファのcompactingのメソッド。

ダブル・バッファは、allocationがバッファ・コンテンツ用の領域を割り当てるか、wrappingが既存のdouble配列 {#if[char]?or string} をバッファに割り当てるか、または既存のbyteバッファのviewを作成することによって作成できます。

byteバッファと同様に、doubleバッファにも「ダイレクト」と「非ダイレクト」があります。 このクラスのwrapメソッドで作成されたdoubleバッファは非ダイレクト・バッファになります。 byteバッファのビューとして作成されたdoubleバッファは、byteバッファがダイレクト・バッファである場合にかぎりダイレクト・バッファになります。 doubleバッファがダイレクト・バッファかどうかは、isDirectメソッドの呼出しによって判断できます。

このクラスのメソッドのうち戻り値を返さないものは、自身を呼び出したバッファの情報を返します。 これを応用して、メソッド呼出しを連鎖させることができます。

導入されたバージョン:
1.4

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    static DoubleBuffer
    allocate​(int capacity)
    新しいdoubleバッファを割り当てます。
    double[]
    array()
    このバッファを補助するdouble配列を返します  (オプションの操作)。
    int
    arrayOffset()
    このバッファの補助配列内にある、このバッファの最初の要素のオフセットを返します  (オプションの操作)。
    abstract DoubleBuffer
    asReadOnlyBuffer()
    このバッファの内容を共有する新しい読込み専用doubleバッファを作成します。
    DoubleBuffer
    clear()
    このバッファをクリアします。
    abstract DoubleBuffer
    compact()
    このバッファを圧縮します  (オプションの操作)。
    int
    compareTo​(DoubleBuffer that)
    このバッファを別のバッファと比較します。
    abstract DoubleBuffer
    duplicate()
    このバッファの内容を共有する新しいdoubleバッファを作成します。
    boolean
    equals​(Object ob)
    このバッファが別のオブジェクトと等価であるかどうかを判断します。
    DoubleBuffer
    flip()
    このバッファをフリップ(反転)します。
    abstract double
    get()
    相対getメソッドです。
    DoubleBuffer
    get​(double[] dst)
    相対一括getメソッドです。
    DoubleBuffer
    get​(double[] dst, int offset, int length)
    相対一括getメソッドです。
    abstract double
    get​(int index)
    絶対getメソッドです。
    DoubleBuffer
    get​(int index, double[] dst)
    絶対一括getメソッド。
    DoubleBuffer
    get​(int index, double[] dst, int offset, int length)
    絶対一括getメソッド。
    boolean
    hasArray()
    このバッファがアクセス可能なdouble配列に連動するかどうかを判断します。
    int
    hashCode()
    このバッファの現在のハッシュ・コードを返します。
    abstract boolean
    isDirect()
    現在のdoubleバッファがダイレクト・バッファであるかどうかを判断します。
    DoubleBuffer
    limit​(int newLimit)
    このバッファのリミットを設定します。
    DoubleBuffer
    mark()
    このバッファの現在位置にマークを設定します。
    int
    mismatch​(DoubleBuffer that)
    このバッファと指定されたバッファの最初の不一致の相対索引を検索して戻します。
    abstract ByteOrder
    order()
    このバッファのbyte順序を取得します。
    DoubleBuffer
    position​(int newPosition)
    このバッファの位置を設定します。
    abstract DoubleBuffer
    put​(double d)
    相対putメソッドです  (オプションの操作)。
    DoubleBuffer
    put​(double[] src)
    相対一括putメソッドです  (オプションの操作)。
    DoubleBuffer
    put​(double[] src, int offset, int length)
    相対一括putメソッドです  (オプションの操作)。
    abstract DoubleBuffer
    put​(int index, double d)
    絶対putメソッドです  (オプションの操作)。
    DoubleBuffer
    put​(int index, double[] src)
    (optional operation)の絶対一括putメソッド。
    DoubleBuffer
    put​(int index, double[] src, int offset, int length)
    (optional operation)の絶対一括putメソッド。
    DoubleBuffer
    put​(int index, DoubleBuffer src, int offset, int length)
    (optional operation)の絶対一括putメソッド。
    DoubleBuffer
    put​(DoubleBuffer src)
    相対一括putメソッドです  (オプションの操作)。
    DoubleBuffer
    reset()
    バッファの位置を以前にマークした位置に戻します。
    DoubleBuffer
    rewind()
    このバッファをリワインド(巻き戻し)します。
    abstract DoubleBuffer
    slice()
    このバッファの内容の共有のサブシーケンスを内容とする新しいdoubleバッファを作成します。
    abstract DoubleBuffer
    slice​(int index, int length)
    このバッファの内容の共有のサブシーケンスを内容とする新しいdoubleバッファを作成します。
    String
    toString()
    このバッファの状態を要約した文字列を返します。
    static DoubleBuffer
    wrap​(double[] array)
    double配列をバッファにラップします。
    static DoubleBuffer
    wrap​(double[] array, int offset, int length)
    double配列をバッファにラップします。

    クラス java.nio.Bufferで宣言されたメソッド

    capacity, hasRemaining, isReadOnly, limit, position, remaining

    クラス java.lang.Objectで宣言されたメソッド

    clone, finalize, getClass, notify, notifyAll, wait, wait, wait

  • メソッドの詳細

    • allocate

      public static DoubleBuffer allocate​(int capacity)
      新しいdoubleバッファを割り当てます。

      新しいバッファの位置は0になり、その限界はその容量になり、マークは未定義になり、各要素はゼロに初期化され、バイト・オーダーは基礎となるハードウェアのnative orderになります。 補助配列を持ち、配列オフセットはゼロになります。

      パラメータ:
      capacity - 新しいバッファの容量(double)
      戻り値:
      新しいdoubleバッファ
      例外:
      IllegalArgumentException - capacityが負の整数である場合

    • wrap

      public static DoubleBuffer wrap​(double[] array, int offset, int length)
      double配列をバッファにラップします。

      新しいバッファは指定されたdouble配列によって補助されます。バッファに変更を加えると配列も変更され、配列に変更を加えるとバッファも変更されます。 新しいバッファの容量はarray.lengthになり、その位置はoffsetになり、その制限はoffset + lengthになり、そのマークは未定義となり、そのバイト順序は基盤となるハードウェアのnative orderになります。 指定された配列が補助配列となり、その配列オフセットはゼロになります。

      パラメータ:
      array - 新しいバッファを補助する配列
      offset -使用するサブ配列のオフセット。array.length以下の負でない値でなければならない。 新しいバッファの位置は、この値に設定される。
      length - 使用するサブ配列の長さ。array.length - offset以下の負でない値でなければならない。 新しいバッファのリミットは、offset+lengthに設定される。
      戻り値:
      新しいdoubleバッファ
      例外:
      IndexOutOfBoundsException - offsetパラメータとlengthパラメータの前提条件が満たされていない場合

    • wrap

      public static DoubleBuffer wrap​(double[] array)
      double配列をバッファにラップします。

      新しいバッファは指定されたdouble配列によって補助されます。バッファに変更を加えると配列も変更され、配列に変更を加えるとバッファも変更されます。 新しいバッファの容量と限界はarray.lengthになり、その位置はゼロになり、マークは未定義になり、そのバイト・オーダーは基盤となるハードウェアのnative orderになります。 指定された配列が補助配列となり、その配列オフセットはゼロになります。

      パラメータ:
      array - このバッファを補助する配列
      戻り値:
      新しいdoubleバッファ

    • slice

      public abstract DoubleBuffer slice()
      このバッファの内容の共有のサブシーケンスを内容とする新しいdoubleバッファを作成します。

      新しいバッファの内容は、このバッファの現在位置から始まります。 このバッファの内容に変更を加えると、その内容が新しいバッファに反映されます。新しいバッファの内容に変更を加えると、その内容がこのバッファに反映されます。2つのバッファの位置、リミット、マークの値はそれぞれ異なります。

      新しいバッファの位置は0になり、その容量と制限はこのバッファに残っているdoubleの数になり、そのマークは未定義になり、そのバイト順序はこのバッファのものと同じになります。 新しいバッファは、このバッファがダイレクト・バッファである場合にかぎりダイレクト・バッファになります。また、このバッファが読取り専用バッファである場合にかぎり読取り専用バッファになります。

      定義:
      クラスBufferのslice
      戻り値:
      新しいdoubleバッファ

    • slice

      public abstract DoubleBuffer slice​(int index, int length)
      このバッファの内容の共有のサブシーケンスを内容とする新しいdoubleバッファを作成します。

      新しいバッファの内容は、このバッファ内のindexの位置から始まり、length要素が含まれます。 このバッファの内容に変更を加えると、その内容が新しいバッファに反映されます。新しいバッファの内容に変更を加えると、その内容がこのバッファに反映されます。2つのバッファの位置、リミット、マークの値はそれぞれ異なります。

      新しいバッファ位置はゼロ、容量とリミットはlength、マークは未定義、バイト順序はこのバッファのものと同一です。 新しいバッファは、このバッファがダイレクト・バッファである場合にかぎりダイレクト・バッファになります。また、このバッファが読取り専用バッファである場合にかぎり読取り専用バッファになります。

      定義:
      クラスBufferのslice
      パラメータ:
      index - 新しいバッファの内容が開始される、このバッファ内の位置。limit()以外の値である必要があります。
      length - 新規バッファに含まれる要素の数。負以外でlimit() - indexより大きい値である必要があります。
      戻り値:
      新しいバッファ
      例外:
      IndexOutOfBoundsException - indexが、limit()以上の場合、lengthがマイナスまたはlength > limit() - index
      導入されたバージョン:
      13

    • 複製

      public abstract DoubleBuffer duplicate()
      このバッファの内容を共有する新しいdoubleバッファを作成します。

      新しいバッファの内容は、このバッファの内容と同じになります。 このバッファの内容に変更を加えると、その内容が新しいバッファに反映されます。新しいバッファの内容に変更を加えると、その内容がこのバッファに反映されます。2つのバッファの位置、リミット、マークの値はそれぞれ異なります。

      新しいバッファ容量、限界、位置、マーク値、およびバイト順は、このバッファのものと同じになります。 新しいバッファは、このバッファがダイレクト・バッファである場合にかぎりダイレクト・バッファになります。また、このバッファが読取り専用バッファである場合にかぎり読取り専用バッファになります。

      定義:
      クラスBufferのduplicate
      戻り値:
      新しいdoubleバッファ

    • asReadOnlyBuffer

      public abstract DoubleBuffer asReadOnlyBuffer()
      このバッファの内容を共有する新しい読込み専用doubleバッファを作成します。

      新しいバッファの内容は、このバッファの内容と同じになります。 このバッファの内容に変更を加えると、その内容が新しいバッファに反映されます。しかし、新しいバッファ自体は読取り専用であり、その共有内容を変更することはできません。 2つのバッファの位置、リミット、マークの値はそれぞれ異なります。

      新しいバッファ容量、限界、位置、マーク値、およびバイト順は、このバッファのものと同じになります。

      このバッファ自身が読込み専用の場合は、このメソッドはduplicateと同じように動作します。

      戻り値:
      新しい読込み専用doubleバッファ

    • get

      public abstract double get()
      相対getメソッドです。 バッファの現在位置にあるdoubleを読み込み、現在位置を増加します。
      戻り値:
      バッファの現在位置のdouble
      例外:
      BufferUnderflowException - バッファの現在位置がリミット以上である場合

    • put

      public abstract DoubleBuffer put​(double d)
      相対putメソッドです  (オプションの操作)。

      このバッファの現在位置に指定されたdoubleを書き込み、現在位置を増加します。

      パラメータ:
      d - 書き込まれるdouble
      戻り値:
      このバッファ
      例外:
      BufferOverflowException - このバッファの現在位置がリミット以上である場合
      ReadOnlyBufferException - このバッファが読込み専用である場合

    • get

      public abstract double get​(int index)
      絶対getメソッドです。 指定されたインデックス位置のdoubleを読み込みます。
      パラメータ:
      index - doubleの読込み位置を示すインデックス
      戻り値:
      指定されたインデックス位置のdouble
      例外:
      IndexOutOfBoundsException - indexが負の数である場合、またはバッファのリミット以上である場合

    • put

      public abstract DoubleBuffer put​(int index, double d)
      絶対putメソッドです  (オプションの操作)。

      このバッファの指定されたインデックス位置に、指定されたdoubleを書き込みます。

      パラメータ:
      index - doubleの書込み先を示すインデックス
      d - 書き込まれるdouble値
      戻り値:
      このバッファ
      例外:
      IndexOutOfBoundsException - indexが負の数である場合、またはバッファのリミット以上である場合
      ReadOnlyBufferException - このバッファが読込み専用である場合

    • get

      public DoubleBuffer get​(double[] dst, int offset, int length)
      相対一括getメソッドです。

      このメソッドは、このバッファから指定された配列へdoubleを転送します。 このバッファ内に残っているdoubleが要求に満たない場合(つまり、length > remaining()である場合)、doubleは一切転送されず、BufferUnderflowExceptionがスローされます。

      それ以外の場合、このメソッドは、length個のdoubleを、このバッファの現在位置から指定された配列の指定されたオフセット位置へコピーします。 そのたびに、このバッファの位置がlengthずつ増加します。

      このメソッドをsrc.get(dst, off, len)の形式で呼び出すと、次のループとまったく同じ結果になります。 

      
     for (int i = off; i < off + len; i++)
         dst[i] = src.get();
      ただし、現在のバッファ内に十分な数のdoubleが存在することを最初に確認する動作は除きます。また、このメソッドを使用したほうがループよりもはるかに効率的です。

      パラメータ:
      dst - doubleの書込み先となる配列
      offset - 最初のdoubleの書込み先となる配列内のオフセット。dst.length以下の負でない値でなければならない
      length - 指定された配列に書き込まれるdoubleの最大数。dst.length - offset以下の負でない値でなければならない
      戻り値:
      このバッファ
      例外:
      BufferUnderflowException - このバッファ内に残っているdouble数がlengthよりも少ない場合
      IndexOutOfBoundsException - offsetパラメータとlengthパラメータの前提条件が満たされていない場合

    • get

      public DoubleBuffer get​(double[] dst)
      相対一括getメソッドです。

      このメソッドは、このバッファから指定された配列へdoubleを転送します。 このメソッドをsrc.get(a)の形式で呼び出すと、次の呼び出しと同じ結果になります。 

           src.get(a, 0, a.length)

      パラメータ:
      dst - コピー先配列
      戻り値:
      このバッファ
      例外:
      BufferUnderflowException - このバッファ内に残っているdouble数がlengthよりも少ない場合

    • get

      public DoubleBuffer get​(int index, double[] dst, int offset, int length)
      絶対一括getメソッド。

      このメソッドは、このバッファから指定された配列にlengthを送ります。このバッファ内の指定された索引から開始し、配列内の指定されたオフセットから開始します。 このバッファの位置は変わりません。

      フォームsrc.get(index, dst, offset, length)のこのメソッドを起動しても、次のループとまったく同じ効果があります。ただし、最初に提供されたパラメータの一貫性がチェックされ、それがさらに効率的である可能性があります: 

      
     for (int i = offset, j = index; i < offset + length; i++, j++)
         dst[i] = src.get(j);

      パラメータ:
      index - 最初のdoubleが読み取られるこのバッファ内のインデックス。負でない値かつlimit()より小さい値である必要があります。
      dst - コピー先配列
      offset - 最初に書き込まれるdoubleの配列内のオフセット。負でない、またはdst.lengthより小さい必要があります
      length - 指定された配列に書き込まれるdoubleの数。limit() - indexおよびdst.length - offsetの小さい値以下の値である必要があります。
      戻り値:
      このバッファ
      例外:
      IndexOutOfBoundsException - index、offsetおよびlengthパラメータの事前条件が満たされていない場合、それらを保持しません
      導入されたバージョン:
      13

    • get

      public DoubleBuffer get​(int index, double[] dst)
      絶対一括getメソッド。

      このメソッドは、このバッファから指定された配列へdoubleを転送します。 このバッファの位置は変わりません。 フォームsrc.get(index, dst)のこのメソッドの起動は、起動とまったく同じ方法で動作します: 

           src.get(index, dst, 0, dst.length)

      パラメータ:
      index - 最初のdoubleが読み取られるこのバッファ内のインデックス。負でない値かつlimit()より小さい値である必要があります。
      dst - コピー先配列
      戻り値:
      このバッファ
      例外:
      IndexOutOfBoundsException - indexが負であるか、limit()より小さくないか、またはlimit() - index < dst.lengthの場合
      導入されたバージョン:
      13

    • put

      public DoubleBuffer put​(DoubleBuffer src)
      相対一括putメソッドです  (オプションの操作)。

      このメソッドは、指定されたソース・バッファ内に残っているdoubleをこのバッファへ転送します。 ソース・バッファ内に残っているdoubleがこのバッファ内に残っているdoubleよりも多い場合(つまり、src.remaining() > remaining()である場合)、doubleは一切転送されず、BufferOverflowExceptionがスローされます。

      それ以外の場合、このメソッドは、指定されたバッファの現在位置からこのバッファの現在位置へn = src.remaining()個のdoubleをコピーします。 そのたびに、両方のバッファの位置がnずつ増加します。

      このメソッドをdst.put(src)の形式で呼び出すと、次のループとまったく同じ結果になります。 

           while (src.hasRemaining())
         dst.put(src.get());
      ただし、このバッファ内に十分な容量があることを最初に確認する動作は除きます。また、このメソッドを使用したほうがループよりもはるかに効率的です。 このバッファとソース・バッファが同じバッキング配列またはメモリーを共有している場合、結果は、このバッファに書き込まれる前にソース要素が最初に中間のロケーションにコピーされたかのようになります。

      パラメータ:
      src - doubleの読込み先となるソース・バッファ(このバッファ以外)
      戻り値:
      このバッファ
      例外:
      BufferOverflowException - このバッファに、ソース・バッファの残りのdoubleを格納できるだけの容量がない場合
      IllegalArgumentException - ソース・バッファとしてこのバッファを指定した場合
      ReadOnlyBufferException - このバッファが読込み専用である場合

    • put

      public DoubleBuffer put​(int index, DoubleBuffer src, int offset, int length)
      (optional operation)の絶対一括putメソッド。

      このメソッドは、ソース・バッファ内の指定されたoffsetおよびこのバッファ内の指定されたindexから、指定されたソース・バッファにlength doubleを転送します。 両方のバッファの位置は変更されません。

      つまり、dst.put(index, src, offset, length)形式のこのメソッドの呼出しは、ループとまったく同じ効果があります 

      
 for (int i = offset, j = index; i < offset + length; i++, j++)
     dst.put(j, src.get(i));
      最初に、指定されたパラメータの一貫性をチェックし、より効率的になる可能性があることを除きます。 このバッファとソース・バッファが同じバッキング配列またはメモリーを共有している場合、結果は、このバッファに書き込まれる前にソース要素が最初に中間のロケーションにコピーされたかのようになります。

      パラメータ:
      index - 最初のdoubleが書き込まれるこのバッファ内のインデックス。負でない値かつlimit()より小さい値である必要があります。
      src - doubleの読取り元バッファ
      offset - 読み込まれる最初のdoubleのソース・バッファ内のインデックス。負ではなく、src.limit()より小さい値である必要があります
      length - 指定されたバッファから読み取られるdoubleの数。limit() - indexおよびsrc.limit() - offsetのいずれか小さい方より小さく、負でない値にする必要があります
      戻り値:
      このバッファ
      例外:
      IndexOutOfBoundsException - index、offsetおよびlengthパラメータの事前条件が満たされていない場合、それらを保持しません
      ReadOnlyBufferException - このバッファが読込み専用である場合
      導入されたバージョン:
      16

    • put

      public DoubleBuffer put​(double[] src, int offset, int length)
      相対一括putメソッドです  (オプションの操作)。

      このメソッドは、指定されたソース配列からこのバッファへdoubleを転送します。 配列からコピーするdoubleがこのバッファ内に残っているdoubleより多い場合(つまり、length > remaining()である場合)、doubleは一切転送されず、BufferOverflowExceptionがスローされます。

      それ以外の場合、このメソッドは、指定された配列の指定されたオフセット位置からこのバッファの現在位置へlength個のdoubleをコピーします。 そのたびに、このバッファの位置がlengthずつ増加します。

      このメソッドをdst.put(src, off, len)の形式で呼び出すと、次のループとまったく同じ結果になります。 

      
     for (int i = off; i < off + len; i++)
         dst.put(src[i]);
      ただし、このバッファ内に十分な容量があることを最初に確認する動作は除きます。また、このメソッドを使用したほうがループよりもはるかに効率的です。

      パラメータ:
      src - double値の読込み先となる配列
      offset - 最初に読み込むdoubleの配列内のオフセット。負以外で、src.length以外の値である必要があります。
      length - 指定された配列から読み取られるdouble型の数。負でないか、src.length - offsetより大きい必要があります
      戻り値:
      このバッファ
      例外:
      BufferOverflowException - このバッファ内に残っている容量が不足している場合
      IndexOutOfBoundsException - offsetパラメータとlengthパラメータの前提条件が満たされていない場合
      ReadOnlyBufferException - このバッファが読込み専用である場合

    • put

      public final DoubleBuffer put​(double[] src)
      相対一括putメソッドです  (オプションの操作)。

      このメソッドは、ソースとなる指定されたdouble配列の内容全体をこのバッファへ転送します。 このメソッドをdst.put(a)の形式で呼び出すと、次の呼び出しと同じ結果になります。 

           dst.put(a, 0, a.length)

      パラメータ:
      src - 転送元配列
      戻り値:
      このバッファ
      例外:
      BufferOverflowException - このバッファ内に残っている容量が不足している場合
      ReadOnlyBufferException - このバッファが読込み専用である場合

    • put

      public DoubleBuffer put​(int index, double[] src, int offset, int length)
      (optional operation)の絶対一括putメソッド。

      このメソッドは、配列内の指定されたオフセットから開始し、このバッファ内の指定された索引からlengthを双方向に転送します。 このバッファの位置は変わりません。

      フォームdst.put(index, src, offset, length)のこのメソッドを起動しても、次のループとまったく同じ効果があります。ただし、最初に提供されたパラメータの一貫性がチェックされ、それがさらに効率的である可能性があります: 

      
     for (int i = offset, j = index; i < offset + length; i++, j++)
         dst.put(j, src[i]);

      パラメータ:
      index - 最初のdoubleが書き込まれるこのバッファ内のインデックス。負でない値かつlimit()より小さい値である必要があります。
      src - double値の読込み先となる配列
      offset - 最初に読み込まれるdoubleの配列内のオフセット。負でない値かつsrc.lengthより小さい値である必要があります。
      length - 特定の配列から読み取られるdouble値の数。limit() - indexおよびsrc.length - offsetの小さい値以下の値である必要があります。
      戻り値:
      このバッファ
      例外:
      IndexOutOfBoundsException - index、offsetおよびlengthパラメータの事前条件が満たされていない場合、それらを保持しません
      ReadOnlyBufferException - このバッファが読込み専用である場合
      導入されたバージョン:
      13

    • put

      public DoubleBuffer put​(int index, double[] src)
      (optional operation)の絶対一括putメソッド。

      このメソッドは、指定されたソース配列からこのバッファにコピーします。 このバッファの位置は変わりません。 フォームdst.put(index, src)のこのメソッドの起動は、起動とまったく同じ方法で動作します: 

           dst.put(index, src, 0, src.length);

      パラメータ:
      index - 最初のdoubleが書き込まれるこのバッファ内のインデックス。負でない値かつlimit()より小さい値である必要があります。
      src - double値の読込み先となる配列
      戻り値:
      このバッファ
      例外:
      IndexOutOfBoundsException - indexが負であるか、limit()より小さくないか、またはlimit() - index < src.lengthの場合
      ReadOnlyBufferException - このバッファが読込み専用である場合
      導入されたバージョン:
      13

    • hasArray

      public final boolean hasArray()
      このバッファがアクセス可能なdouble配列に連動するかどうかを判断します。

      このメソッドの戻り値がtrueであれば、arrayおよびarrayOffsetメソッドを安全に呼び出すことができます。

      定義:
      hasArray、クラス: Buffer
      戻り値:
      このバッファが配列に連動しており、読取り専用でない場合にかぎりtrue

    • array

      public final double[] array()
      このバッファを補助するdouble配列を返します  (オプションの操作)。

      このバッファの内容に変更を加えると、返される配列の内容も変更されます。その逆も同様です。

      このメソッドを呼び出す前にhasArrayメソッドを呼び出し、このバッファがアクセス可能な補助配列を持っていることを確認します。

      定義:
      array、クラス: Buffer
      戻り値:
      このバッファを補助する配列
      例外:
      ReadOnlyBufferException - このバッファが配列に連動しており、しかも読込み専用である場合
      UnsupportedOperationException - このバッファがアクセス可能な配列を利用しない場合

    • arrayOffset

      public final int arrayOffset()
      このバッファの補助配列内にある、このバッファの最初の要素のオフセットを返します  (オプションの操作)。

      このバッファが配列に連動していれば、その位置pが配列のインデックスp + arrayOffset()と一致します。

      このメソッドを呼び出す前にhasArrayメソッドを呼び出し、このバッファがアクセス可能な補助配列を持っていることを確認します。

      定義:
      arrayOffset、クラス: Buffer
      戻り値:
      このバッファの配列内にある、このバッファの最初の要素のオフセット
      例外:
      ReadOnlyBufferException - このバッファが配列に連動しており、しかも読込み専用である場合
      UnsupportedOperationException - このバッファがアクセス可能な配列を利用しない場合

    • position

      public final DoubleBuffer position​(int newPosition)
      このバッファの位置を設定します。 新しい位置の値よりもマークの値のほうが大きい場合、マークの定義は破棄されます。
      オーバーライド:
      クラスBufferのposition
      パラメータ:
      newPosition - 新しい位置の値は、現在のリミット以下の負でない値でなければならない
      戻り値:
      このバッファ

    • limit

      public final DoubleBuffer limit​(int newLimit)
      このバッファのリミットを設定します。 位置の値が新しいリミットより大きい場合、リミットと同じ値に変更されます。 マークの値が新しいリミットより大きい場合、マークの定義は破棄されます。
      オーバーライド:
      クラスBufferのlimit
      パラメータ:
      newLimit - 新しいリミット値は、このバッファの容量以下の負でない値でなければならない
      戻り値:
      このバッファ

    • mark

      public final DoubleBuffer mark()
      このバッファの現在位置にマークを設定します。
      オーバーライド:
      クラスBufferのmark
      戻り値:
      このバッファ

    • reset

      public final DoubleBuffer reset()
      バッファの位置を以前にマークした位置に戻します。

      このメソッドを呼び出しても、マークの値は変更されません。マークが破棄されることもありません。

      オーバーライド:
      クラスBufferのreset
      戻り値:
      このバッファ

    • clear

      public final DoubleBuffer clear()
      このバッファをクリアします。 バッファの位置はゼロ、リミットは容量の値に設定されます。マークは破棄されます。

      一連のチャネル読込み操作または「put」操作を使用してこのバッファにデータを格納する前に、このメソッドを呼び出します。 次に例を示します。 

       buf.clear();     // Prepare buffer for reading
 in.read(buf);    // Read data

      このメソッドはバッファ内のデータを実際に消去するわけではありません。しかし、そうした状況で使用されるため、クリアと命名されています。

      オーバーライド:
      クラスBufferのclear
      戻り値:
      このバッファ

    • flip

      public final DoubleBuffer 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メソッドと組み合わせて使用することがあります。

      オーバーライド:
      クラスBufferのflip
      戻り値:
      このバッファ

    • rewind

      public final DoubleBuffer rewind()
      このバッファをリワインド(巻き戻し)します。 位置はゼロに設定され、マークは破棄されます。

      このメソッドは、リミットを正しく設定したあと、一連のチャネル書込み操作(get)の前に呼び出します。 次に例を示します。 

       out.write(buf);    // Write remaining data
 buf.rewind();      // Rewind buffer
 buf.get(array);    // Copy data into array

      オーバーライド:
      クラスBufferのrewind
      戻り値:
      このバッファ

    • compact

      public abstract DoubleBuffer compact()
      このバッファを圧縮します  (オプションの操作)。

      バッファの現在位置からリミットまでの間にdoubleが存在する場合、これらをバッファの先頭にコピーします。 つまり、インデックス位置p = position()のdoubleがインデックス・ゼロにコピーされ、インデックス位置p + 1のdoubleがインデックス1にコピーされるということです。インデックス位置limit() - 1のdoubleがインデックスn = limit() - 1 - pにコピーされるまで、同様の処理が繰り返されます。 最終的にバッファの位置はn+1に設定され、リミットは容量の値と等しくなります。 マークは破棄されます。

      バッファの位置は、ゼロではなく、コピーされるdoubleの数と等しくなります。したがって、このメソッドを呼び出したあと、すぐに別の相対「put」メソッドを呼び出すことができます。

      戻り値:
      このバッファ
      例外:
      ReadOnlyBufferException - このバッファが読込み専用である場合

    • isDirect

      public abstract boolean isDirect()
      現在のdoubleバッファがダイレクト・バッファであるかどうかを判断します。
      定義:
      isDirect、クラス: Buffer
      戻り値:
      このバッファがダイレクト・バッファである場合にかぎりtrue

    • toString

      public String toString()
      このバッファの状態を要約した文字列を返します。
      オーバーライド:
      toString 、クラス:  Object
      戻り値:
      サマリー文字列

    • hashCode

      public int hashCode()
      このバッファの現在のハッシュ・コードを返します。

      doubleバッファのハッシュ・コードは、バッファ内に残っている要素、すなわちposition()からlimit() - 1までの要素のみに依存します。

      バッファのハッシュ・コードは内容依存型です。今後バッファの内容が変更されないことが明らかでないかぎり、バッファをハッシュ・マップその他のデータ構造のキーとして使用することは避けてください。

      オーバーライド:
      hashCode 、クラス:  Object
      戻り値:
      このバッファの現在のハッシュ・コード
      関連項目:
      Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

    • equals

      public boolean equals​(Object ob)
      このバッファが別のオブジェクトと等価であるかどうかを判断します。

      2つのdoubleバッファは、次の場合にかぎり等価です。

      1. 要素の型が同じである

      2. バッファ内に残っている要素数が同じである

      3. バッファ内に残っている要素のシーケンス(開始位置とは無関係)が各点で等しい(pointwise equal) (a == b)||(Double.isNaN(a)&& Double.isNaN(b))の場合、このメソッドでは2つのdouble要素aとbは等価とみなされます。 Double.equals(Object)とは異なり、値-0.0と+0.0は等価とみなされます。

      doubleバッファが、その他の型のオブジェクトと等価になることはありません。

      オーバーライド:
      equals 、クラス:  Object
      パラメータ:
      ob - このバッファと比較するオブジェクト
      戻り値:
      このバッファが指定されたオブジェクトと等価である場合にかぎりtrue
      関連項目:
      Object.hashCode()、HashMap

    • compareTo

      public int compareTo​(DoubleBuffer that)
      このバッファを別のバッファと比較します。

      2つのdoubleバッファを比較する際は、バッファ内に残っている要素のシーケンスが辞書順に比較されます。このとき、双方のバッファ内に残っているシーケンスの開始位置は考慮されません。 double要素のペアは、Double.compare(double,double)を呼び出すことによって比較されます。ただし、-0.0と0.0は等価と見なされます。 このメソッドでは、Double.NaNは自身に等しく、ほかのすべてのdouble値(Double.POSITIVE_INFINITYを含む)よりも大きいとみなされる。

      doubleバッファとその他の型のオブジェクトを比較することはできません。

      定義:
      compareTo、インタフェース: Comparable<DoubleBuffer>
      パラメータ:
      that - 比較対象のオブジェクト。
      戻り値:
      このバッファが指定されたバッファより小さい場合は負の整数、等しい場合はゼロ、大きい場合は正の整数

    • mismatch

      public int mismatch​(DoubleBuffer that)
      このバッファと指定されたバッファの最初の不一致の相対索引を検索して戻します。 インデックスは各バッファのpositionに相対的であり、各バッファ(inclusive)の範囲が各バッファremainingの範囲内で小さくなる。

      2つのバッファが共通プレフィクスを共有している場合、戻される索引は共通プレフィクスの長さとなり、各バッファ内のその索引の2つのバッファ間に不一致があることに従います。 一方のバッファがもう一方のバッファのプレフィクスである場合、戻された索引は各バッファ内の残りの要素の小さい方になり、残りの要素の数が多いバッファに対してのみ索引が有効になります。 それ以外の場合は、不一致はありません。

      パラメータ:
      that - このバッファと不一致をテストするためのバイト・バッファ
      戻り値:
      このバッファと指定されたバッファの最初の不一致の相対索引です。一致しない場合は -1です。
      導入されたバージョン:
      11

    • order

      public abstract ByteOrder order()
      このバッファのbyte順序を取得します。

      割り当てまたは既存のdouble配列のラップによって作成されたdoubleバッファのbyte順序は、基礎となるハードウェアのネイティブ順序と同じになります。 byteバッファのビューとして作成されたdoubleバッファのbyte順序は、ビューを作成した時点のbyteバッファのbyte順序と同じになります。

      戻り値:
      このバッファのbyte順序