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

クラスLongBuffer

  • すべての実装されたインタフェース:
    Comparable<LongBuffer>

    public abstract class LongBuffer
    extends Buffer
    implements Comparable<LongBuffer>
    longバッファです。

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

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

    • 連続したlongシーケンスをこのバッファから配列へと転送する相対一括getメソッド。

    • 連続したlongシーケンスをlong配列やその他のlongバッファからこのバッファへと転送する相対一括putメソッド。

    • 長いバッファをcompactingするメソッド。

    longバッファを作成するには、バッファの内容に容量を割り当てる割り当てを実行するか、既存のlong配列をバッファ内にラップするか、既存のbyteバッファのビューを作成します。

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

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

    導入されたバージョン:
    1.4
    • メソッドのサマリー

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

      • allocate

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

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

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

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

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

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

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

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

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

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

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

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

        定義:
        クラスBufferslice
        戻り値:
        新しいlongバッファ
      • duplicate

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

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

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

        定義:
        クラスBufferduplicate
        戻り値:
        新しいlongバッファ
      • asReadOnlyBuffer

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

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

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

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

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

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

        public abstract LongBuffer put​(long l)
        相対putメソッドです  (オプションの操作)

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

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

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

        public abstract LongBuffer put​(int index,
                                       long l)
        絶対putメソッドです  (オプションの操作)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

        3. バッファ内に残っている要素のシーケンス(開始位置とは無関係)が各点で等しい(pointwise equal)

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

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

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

        2つのlongバッファを比較する際は、バッファ内に残っている要素のシーケンスが辞書順に比較されます。このとき、双方のバッファ内に残っているシーケンスの開始位置は考慮されません。 Long.compare(long,long)を呼び出したかのように、long要素のペアが比較されます。

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

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

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

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

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

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

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

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