クラスLongBuffer

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

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

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

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

  • 長い配列またはその他の長いバッファからこのバッファに連続した長さのシーケンスを転送する絶対および相対的なbulk putメソッド

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

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

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

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

オプションの操作

「オプションの操作」として指定されたメソッドは、read-only LongBufferで呼び出されるとReadOnlyBufferExceptionをスローします。 LongBufferが「アクセス可能なlong配列」 (LongBufferが読取り専用かどうかに関係なく)に支えられていない場合、メソッド「配列」およびarrayOffsetはUnsupportedOperationExceptionをスローします。
導入されたバージョン:
1.4

  • メソッドのサマリー

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

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

    capacity, hasRemaining, isReadOnly, limit, position, remaining

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

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

  • メソッドの詳細

    • allocate

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

      新しいバッファの位置はゼロ、その制限は容量、マークは未定義、各要素はゼロに初期化され、そのバイト順序は基礎となるハードウェアのnative orderになります。 backing arrayがあり、そのarray offsetはゼロになります。

      パラメータ:
      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になります。 そのbacking arrayは指定された配列になり、そのarray offsetはゼロになります。

      パラメータ:
      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になります。 そのbacking arrayは指定された配列になり、そのarray offsetはゼロになります。

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

    • slice

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

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

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

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

    • slice

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

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

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

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

    • duplicate

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

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

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

      定義:
      クラスBufferのduplicate
      戻り値:
      新しい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を転送します。 バッファの残り時間が、リクエストを満たすために必要となる長さより少ない場合、つまり、length > remaining()の場合、転送される時間がなく、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 - 書き込まれる最初の長さの配列内のオフセット。負以外で、dst.length以下である必要があります
      length - 指定された配列に書き込まれる最大長。負以外で、dst.length - offset以下である必要があります
      戻り値:
      このバッファ
      スロー:
      BufferUnderflowException - このバッファの残りがlengthより少ない場合
      IndexOutOfBoundsException - offsetパラメータとlengthパラメータの前提条件が満たされていない場合

    • get

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

      このメソッドは、このバッファから指定された配列へlongを転送します。 src.get(a)形式のこのメソッドの起動は、起動とまったく同じように動作 

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

      パラメータ:
      dst - コピー先配列
      戻り値:
      このバッファ
      スロー:
      BufferUnderflowException - このバッファの残りがlengthより少ない場合

    • get

      public LongBuffer get(int index, long[] 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 - このバッファ内の最初の長さの読取り元索引。負でない値またはlimit()より小さい値である必要があります。
      dst - コピー先配列
      offset - 最初に書き込まれる長さの配列内のオフセット。dst.lengthより短く、小さくする必要があります。
      length - 指定された配列に書き込まれる長期の数。limit() - indexおよびdst.length - offsetの小さい方より、負でない数である必要があります。
      戻り値:
      このバッファ
      スロー:
      IndexOutOfBoundsException - index、offsetおよびlengthパラメータの事前条件が満たされていない場合、それらを保持しません
      導入されたバージョン:
      13

    • get

      public LongBuffer get(int index, long[] dst)
      絶対一括getメソッド。

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

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

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

    • put

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

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

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

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

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

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

    • put

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

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

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

    • put

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

      このメソッドは、指定されたソース配列からこのバッファへlongを転送します。 配列からコピーされる時間が、このバッファに残らない場合、つまり、length > remaining()の場合、転送される時間がなく、BufferOverflowExceptionがスローされます。

      それ以外の場合、このメソッドは、指定された配列からこのバッファにlength longをコピーします。このバッファは、配列内の指定されたオフセットから、このバッファの現在の位置で始まります。 このバッファの位置は、lengthによって増分されます。

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

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

      パラメータ:
      src - longの読込み先となる配列
      offset - 読み込まれる最初の長さの配列内のオフセット。負でない値でsrc.lengthより大きい値である必要があります。
      length - 指定された配列から読み取られる長期の数。負でない数で、src.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 - このバッファが読込み専用である場合

    • put

      public LongBuffer put(int index, long[] 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 - 最初の長さが書き込まれるこのバッファ内のインデックス。limit()以上でない必要があります。
      src - longの読込み先となる配列
      offset - 最初に読み込まれるまでの時間の配列内のオフセット。src.lengthより短く、小さくする必要があります。
      length - 指定された配列から読み取られる長期の数。limit() - indexおよびsrc.length - offsetの小さい方より、負でない数である必要があります。
      戻り値:
      このバッファ
      スロー:
      IndexOutOfBoundsException - index、offsetおよびlengthパラメータの事前条件が満たされていない場合、それらを保持しません
      ReadOnlyBufferException - このバッファが読込み専用である場合
      導入されたバージョン:
      13

    • put

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

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

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

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

    • 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 - このバッファがアクセス可能な配列を利用しない場合

    • position

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

    • limit

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

    • mark

      public final LongBuffer mark()
      このバッファの現在位置にマークを設定します。
      オーバーライド:
      クラスBufferのmark
      戻り値:
      このバッファ
      導入されたバージョン:
      9

    • reset

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

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

      オーバーライド:
      クラスBufferのreset
      戻り値:
      このバッファ
      導入されたバージョン:
      9

    • clear

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

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

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

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

      オーバーライド:
      クラスBufferのclear
      戻り値:
      このバッファ
      導入されたバージョン:
      9

    • flip

      public final LongBuffer 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
      戻り値:
      このバッファ
      導入されたバージョン:
      9

    • rewind

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

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

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

      オーバーライド:
      クラスBufferのrewind
      戻り値:
      このバッファ
      導入されたバージョン:
      9

    • compact

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

      バッファの現在位置からリミットまでの間にlongが存在する場合、これらをバッファの先頭にコピーします。 つまり、長い索引p = position()は索引0にコピーされ、長い索引p + 1は索引1にコピーされ、長い索引limit()までコピーされます-1が索引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()
      このバッファの現在のハッシュ・コードを返します。

      長いバッファのハッシュ・コードは、残りの要素にのみ依存します。つまり、position()の要素からlimit()の要素までの要素、およびそれに含まれる要素によって決まります-1。

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

      オーバーライド:
      hashCode、クラスObject
      戻り値:
      このバッファの現在のハッシュ・コード
      関連項目:

    • equals

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

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

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

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

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

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

      オーバーライド:
      equals、クラスObject
      パラメータ:
      ob - このバッファと比較するオブジェクト
      戻り値:
      このバッファが指定されたオブジェクトと等しい場合のみ、true
      関連項目:

    • 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に相対的であり、0 (包含)から各バッファのremainingの要素(除外)まで範囲になります。

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

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

    • order

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

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

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