JavaTM Platform
Standard Ed. 6

java.nio
クラス IntBuffer

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

public abstract class IntBuffer
extends Buffer
implements Comparable<IntBuffer>

int バッファーです。

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

Int バッファーは、バッファーのコンテンツに容量を割り当てる方法 (容量の割り当て)、既存の int 配列をバッファーにラップする方法 (ラップ)、または既存の byte バッファーの「ビュー」を作成する方法で作成できます。

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

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

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

メソッドの概要
static IntBuffer allocate(int capacity)
          新しい int バッファーを割り当てます。
 int[] array()
          現在のバッファーを補助するバイト配列を返します (オプション)。
 int arrayOffset()
          現在のバッファーの補助配列内にある、このバッファーの最初の要素のオフセットを返します (オプション)。
abstract  IntBuffer asReadOnlyBuffer()
          現在のバッファーのコンテンツを共有する新しい読み込み専用 int バッファーを作成します。
abstract  IntBuffer compact()
          現在のバッファーを圧縮します (オプション)。
 int compareTo(IntBuffer that)
          現在のバッファーを別のバッファーと比較します。
abstract  IntBuffer duplicate()
          現在のバッファーのコンテンツを共有する新しい int バッファーを作成します。
 boolean equals(Object ob)
          現在のバッファーが別のオブジェクトと等価であるかどうかを判断します。
abstract  int get()
          相対「get」メソッドです。
abstract  int get(int index)
          絶対「get」メソッドです。
 IntBuffer get(int[] dst)
          相対一括「get」メソッドです。
 IntBuffer get(int[] dst, int offset, int length)
          相対一括「get」メソッドです。
 boolean hasArray()
          現在のバッファーがアクセス可能な int 配列に連動するかどうかを判断します。
 int hashCode()
          現在のバッファーの現在のハッシュコードを返します。
abstract  boolean isDirect()
          現在の int バッファーがダイレクトバッファーであるかどうかを判断します。
abstract  ByteOrder order()
          現在のバッファーのバイト順序を取得します。
abstract  IntBuffer put(int i)
          相対「put」メソッドです (オプション)。
 IntBuffer put(int[] src)
          相対一括「put」メソッドです (オプション)。
 IntBuffer put(int[] src, int offset, int length)
          相対一括「put」メソッドです (オプション)。
 IntBuffer put(IntBuffer src)
          相対一括「put」メソッドです (オプション)。
abstract  IntBuffer put(int index, int i)
          絶対「put」メソッドです (オプション)。
abstract  IntBuffer slice()
          現在のバッファーのコンテンツの共有のサブシーケンスをコンテンツとする新しい int バッファーを作成します。
 String toString()
          このバッファーの状態を要約した文字列を返します。
static IntBuffer wrap(int[] array)
          int 配列をバッファーにラップします。
static IntBuffer wrap(int[] array, int offset, int length)
          int 配列をバッファーにラップします。
 
クラス 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 IntBuffer allocate(int capacity)
新しい int バッファーを割り当てます。

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

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

wrap

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

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

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

wrap

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

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

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

slice

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

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

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

戻り値:
新しい int バッファー

duplicate

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

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

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

戻り値:
新しい int バッファー

asReadOnlyBuffer

public abstract IntBuffer asReadOnlyBuffer()
現在のバッファーのコンテンツを共有する新しい読み込み専用 int バッファーを作成します。

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

新しいバッファーの容量、リミット、位置、マークの値は、現在のバッファーの対応する値と同じになります。

現在のバッファーが読み取り専用の場合、このメソッドの動作は duplicate メソッドとまったく同じになります。

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

get

public abstract int get()
相対「get」メソッドです。現在のバッファーの現在位置の int 値を読み込み、現在位置の値を増加します。

戻り値:
バッファーの現在位置の int 値
例外:
BufferUnderflowException - バッファーの現在位置がリミット以上である場合

put

public abstract IntBuffer put(int i)
相対「put」メソッドです (オプション)。

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

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

get

public abstract int get(int index)
絶対「get」メソッドです。指定されたインデックス位置の int 値を読み込みます。

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

put

public abstract IntBuffer put(int index,
                              int i)
絶対「put」メソッドです (オプション)。

現在のバッファーの指定されたインデックス位置に指定された int 値を書き込みます。

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

get

public IntBuffer get(int[] dst,
                     int offset,
                     int length)
相対一括「get」メソッドです。

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

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

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

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

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

get

public IntBuffer get(int[] dst)
相対一括「get」メソッドです。

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

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

戻り値:
現在のバッファー
例外:
BufferUnderflowException - 現在のバッファー内に残っている int 値の数が length よりも少ない場合

put

public IntBuffer put(IntBuffer src)
相対一括「put」メソッドです (オプション)。

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

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

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

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

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

put

public IntBuffer put(int[] src,
                     int offset,
                     int length)
相対一括「put」メソッドです (オプション)。

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

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

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

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

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

put

public final IntBuffer put(int[] src)
相対一括「put」メソッドです (オプション)。

このメソッドは、ソースとなる指定された int 配列のコンテンツ全体を現在のバッファーへ転送します。このメソッドを dst.put(a) の形式で呼び出すと、以下の呼び出しと同じ結果になります。

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

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

hasArray

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

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

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

array

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

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

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

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

arrayOffset

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

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

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

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

compact

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

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

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

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

isDirect

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

定義:
クラス Buffer 内の isDirect
戻り値:
現在のバッファーがダイレクトバッファーである場合にかぎり true

toString

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

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

hashCode

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

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

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

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

equals

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

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

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

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

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

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

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

compareTo

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

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

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

定義:
インタフェース Comparable<IntBuffer> 内の compareTo
パラメータ:
that - 比較対象のオブジェクト
戻り値:
short バッファーとその他の型のオブジェクトを比較することはできません。 現在のバッファーがもう一方のバッファーより小さい場合は負の整数、等しい場合は 0、大きい場合は正の整数

order

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

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

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

JavaTM Platform
Standard Ed. 6

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

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