JavaTM 2 Platform
Standard Ed. 5.0

java.nio
クラス LongBuffer

java.lang.Object
  上位を拡張 java.nio.Buffer
      上位を拡張 java.nio.LongBuffer
すべての実装されたインタフェース:
Comparable<LongBuffer>

public abstract class LongBuffer
extends Buffer
implements Comparable<LongBuffer>

long バッファです。

このクラスに定義されている long バッファに対する操作は、次の 4 つのカテゴリに分類できます。

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 バッファがダイレクトバッファであるかどうかを判断します。
abstract  ByteOrder order()
          現在のバッファのバイト順序を取得します。
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 配列をバッファにラップします。
 
クラス java.nio.Buffer から継承されたメソッド
capacity, clear, flip, hasRemaining, isReadOnly, limit, limit, mark, position, position, remaining, reset, rewind
 
クラス java.lang.Object から継承されたメソッド
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

メソッドの詳細

allocate

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

新しいバッファの位置は 0、リミットは容量と同じ値になります。マークは定義されません。このバッファは補助配列を利用し、その配列オフセットは 0 になります。

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

wrap

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

新しいバッファは指定された long 配列によって補助されます。バッファに変更を加えると配列も変更され、配列に変更を加えるとバッファも変更されます。新しいバッファの容量は array.length、位置は offset、リミットは offset + length になります。マークは定義されません。指定された配列が補助配列となり、その配列オフセットは 0 になります。

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

wrap

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

新しいバッファは指定された long 配列によって補助されます。バッファに変更を加えると配列も変更され、配列に変更を加えるとバッファも変更されます。新しいバッファの容量とリミットは array.length、位置は 0 になります。マークは定義されません。指定された配列が補助配列となり、その配列オフセットは 0 になります。

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

slice

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

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

新しいバッファの位置は 0、容量とリミットはこのバッファ内に残っている long 値の数になります。マークは定義されません。新しいバッファは、このバッファがダイレクトバッファである場合に限りダイレクトバッファになります。また、このバッファが読み取り専用バッファである場合に限り読み取り専用バッファになります。

戻り値:
新しい long バッファ

duplicate

public abstract LongBuffer duplicate()
現在のバッファのコンテンツを共有する新しい long バッファを作成します。

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

新しいバッファの容量、リミット、位置、マークの値は、現在のバッファの対応する値と同じになります。新しいバッファは、現在のバッファがダイレクトバッファである場合に限りダイレクトバッファになります。また、現在のバッファが読み取り専用バッファである場合に限り読み取り専用バッファになります。

戻り値:
新しい 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 値の書き込み先となる配列内のオフセット。0 以上かつ dst.length 以下の数でなければならない
length - 指定された配列に書き込まれる long 値の最大数。0 以上かつ 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) 

戻り値:
現在のバッファ
例外:
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 値の読み込み先となる配列内のオフセット。0 以上かつ array.length 以下の数でなければならない
length - 指定された配列から読み取られる long 値の数。0 以上かつ 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) 

戻り値:
現在のバッファ
例外:
BufferOverflowException - 現在のバッファ内に残っている容量が不足している場合
ReadOnlyBufferException - 現在のバッファが読み取り専用バッファである場合

hasArray

public final boolean hasArray()
現在のバッファがアクセス可能な long 配列によって補助されているかどうかを判断します。

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

戻り値:
現在のバッファが配列によって補助されており、読み取り専用でない場合に限り true

array

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

現在のバッファのコンテンツに変更を加えると、返される配列のコンテンツも変更されます。その逆も同様です。

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

戻り値:
現在のバッファを補助する配列
例外:
ReadOnlyBufferException - 現在のバッファが配列によって補助されており、しかも読み取り専用である場合
UnsupportedOperationException - 現在のバッファがアクセス可能な配列によって補助されていない場合

arrayOffset

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

現在のバッファが配列によって補助されていれば、その位置 p が配列のインデックス p + arrayOffset() と一致します。

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

戻り値:
現在のバッファの配列内にある、このバッファの最初の要素のオフセット
例外:
ReadOnlyBufferException - 現在のバッファが配列によって補助されており、しかも読み取り専用である場合
UnsupportedOperationException - 現在のバッファがアクセス可能な配列によって補助されていない場合

compact

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

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

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

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

isDirect

public abstract boolean isDirect()
現在の long バッファがダイレクトバッファであるかどうかを判断します。

戻り値:
現在のバッファがダイレクトバッファである場合に限り true

toString

public String toString()
このバッファの状態を要約した文字列を返します。

オーバーライド:
クラス Object 内の toString
戻り値:
概要文字列

hashCode

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

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

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

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

equals

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

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

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

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

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

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

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

compareTo

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

2 つの long バッファを比較する際は、バッファ内に残っている要素のシーケンスが辞書順に比較されます。このとき、双方のバッファ内に残っている各シーケンスの開始位置は考慮されません。

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

定義:
インタフェース Comparable<LongBuffer> 内の compareTo
パラメータ:
that - 比較対象の Object
戻り値:
現在のバッファがもう一方のバッファより小さい場合は負の整数、等しい場合は 0、大きい場合は正の整数

order

public abstract ByteOrder order()
現在のバッファのバイト順序を取得します。

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

戻り値:
現在のバッファのバイト順序

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。