Array (Java Platform SE 6)

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM Platform
Standard Ed. 6

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

java.lang.reflect
クラス Array

java.lang.Object
  java.lang.reflect.Array

public final class Array
extends Object
extends Object

Array クラスは、Java 配列を動的に作成してアクセスするための static メソッドを提供します。

Array は、取得動作または設定動作中に起こる拡大変換は許可しますが、縮小変換が起こると IllegalArgumentException がスローされます。

メソッドの概要
`static Object`	`get(Object array, int index)` 指定された配列オブジェクトの指定されたインデックスのコンポーネント値を返します。
`static boolean`	`getBoolean(Object array, int index)` 指定されたオブジェクトの指定されたインデックスのコンポーネント値を `boolean` として返します。
`static byte`	`getByte(Object array, int index)` 指定された配列オブジェクトの指定されたインデックスのコンポーネント値を `byte` として返します。
`static char`	`getChar(Object array, int index)` 指定された配列オブジェクトの指定されたインデックスのコンポーネント値を `char` として返します。
`static double`	`getDouble(Object array, int index)` 指定された配列オブジェクトの指定されたインデックスのコンポーネント値を `double` として返します。
`static float`	`getFloat(Object array, int index)` 指定された配列オブジェクトの指定されたインデックスのコンポーネント値を `float` として返します。
`static int`	`getInt(Object array, int index)` 指定された配列オブジェクト内の指定されたインデックスのコンポーネント値を `int` として返します。
`static int`	`getLength(Object array)` 配列オブジェクトの長さを `int` で返します。
`static long`	`getLong(Object array, int index)` 指定された配列オブジェクトの指定されたインデックスのコンポーネント値を `long` として返します。
`static short`	`getShort(Object array, int index)` 指定された配列オブジェクトの指定されたインデックスのコンポーネント値を `short` として返します。
`static Object`	`newInstance(Class<?> componentType, int... dimensions)` 指定されたコンポーネント型と大きさで新しい配列を作成します。
`static Object`	`newInstance(Class<?> componentType, int length)` 指定されたコンポーネント型とコンポーネントサイズを使用して新しい配列を作成します。
`static void`	`set(Object array, int index, Object value)` 指定された配列オブジェクトのインデックス付きコンポーネントの値を、指定された新しい値に設定します。
`static void`	`setBoolean(Object array, int index, boolean z)` 指定された配列オブジェクトの指定されたインデックスのコンポーネント値を、指定された `boolean` 値に設定します。
`static void`	`setByte(Object array, int index, byte b)` 指定された配列オブジェクトの指定されたインデックスのコンポーネント値を、指定された `byte` 値に設定します。
`static void`	`setChar(Object array, int index, char c)` 指定された配列オブジェクトのインデックス化されたコンポーネント値を、指定された `char` 値に設定します。
`static void`	`setDouble(Object array, int index, double d)` 指定された配列オブジェクトの指定されたインデックスのコンポーネント値を、指定された `double` 値に設定します。
`static void`	`setFloat(Object array, int index, float f)` 指定された配列オブジェクトの指定されたインデックスのコンポーネント値を、指定された `float` 値に設定します。
`static void`	`setInt(Object array, int index, int i)` 指定された配列オブジェクトの指定されたインデックスのコンポーネント値を、指定された `int` 値に設定します。
`static void`	`setLong(Object array, int index, long l)` 指定された配列オブジェクトの指定されたインデックスのコンポーネント値を、指定された `long` 値に設定します。
`static void`	`setShort(Object array, int index, short s)` 指定された配列オブジェクトの指定されたインデックスのコンポーネントを、指定された `short` 値に設定します。

クラス java.lang.Object から継承されたメソッド
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

メソッドの詳細

newInstance

public static Object newInstance(Class<?> componentType,
                                 int length)
                          throws NegativeArraySizeException

指定されたコンポーネント型とコンポーネントサイズを使用して新しい配列を作成します。このメソッド呼び出しの動作は、次のように配列を作成した場合と同じです。

 int[] x = {length};
 Array.newInstance(componentType, x);

パラメータ:: componentType - 新しい配列のコンポーネント型を表す Class オブジェクト; length - 新しい配列の長さ
戻り値:: 新しい配列
例外:: NullPointerException - 指定された componentType パラメータが null の場合; IllegalArgumentException - componentType が Void.TYPE の場合; NegativeArraySizeException - 指定された length が負の場合

newInstance

public static Object newInstance(Class<?> componentType,
                                 int... dimensions)
                          throws IllegalArgumentException,
                                 NegativeArraySizeException

指定されたコンポーネント型と大きさで新しい配列を作成します。componentType が配列でないクラスまたはインタフェースを表す場合、新しい配列の大きさは dimensions.length、コンポーネント型は componentType です。componentType が配列クラスを表す場合、新しい配列の次元数は、dimensions.length および componentType の次元数の合計です。この場合、新しい配列のコンポーネント型は componentType のコンポーネント型です。

新しい配列の次元数は、実装がサポートしている配列の次元数 (通常は 255) を超えてはいけません。

パラメータ:: componentType - 新しい配列のコンポーネント型を表す Class オブジェクト; dimensions - 新しい配列の次元数を表す int の配列
戻り値:: 新しい配列
例外:: NullPointerException - 指定された componentType 引数が null の場合; IllegalArgumentException - 指定された dimensions 引数が大きさがゼロの配列である場合、要求された次元数が実装によってサポートされる配列の次元数の限度 (通常は 255) を超えている場合、または componentType が Void.TYPE の場合; NegativeArraySizeException - 指定された dimensions 引数のコンポーネントのどれかが負の場合

getLength

public static int getLength(Object array)
                     throws IllegalArgumentException

配列オブジェクトの長さを int で返します。

パラメータ:: array - メッセージデータの長さ
戻り値:: 配列の長さ
例外:: IllegalArgumentException - オブジェクト引数が配列ではない場合

get

public static Object get(Object array,
                         int index)
                  throws IllegalArgumentException,
                         ArrayIndexOutOfBoundsException

指定された配列オブジェクトの指定されたインデックスのコンポーネント値を返します。プリミティブ型の場合、オブジェクト内に自動的に格納されてから返されます。

パラメータ:: array - メッセージデータの長さ; index - インデックス
戻り値:: 指定された配列の指定されたインデックスのコンポーネント (おそらくラップされた) 値
例外:: NullPointerException - 指定されたオブジェクトが null の場合; IllegalArgumentException - 指定されたオブジェクトが配列ではない場合; ArrayIndexOutOfBoundsException - 指定された index 引数が負の場合、または指定された index 引数が指定された配列の長さ以上の場合

getBoolean

public static boolean getBoolean(Object array,
                                 int index)
                          throws IllegalArgumentException,
                                 ArrayIndexOutOfBoundsException

指定されたオブジェクトの指定されたインデックスのコンポーネント値を boolean として返します。

パラメータ:: array - メッセージデータの長さ; index - インデックス
戻り値:: 指定された配列の指定されたインデックスのコンポーネント値
例外:: NullPointerException - 指定されたオブジェクトが null の場合; IllegalArgumentException - 指定されたオブジェクトが配列ではない場合、またはインデックスのコンポーネントを識別子または拡大変換によって戻り値の型に変換できない場合; ArrayIndexOutOfBoundsException - 指定された index 引数が負の場合、または指定された index 引数が指定された配列の長さ以上の場合
関連項目:: get(java.lang.Object, int)

getByte

public static byte getByte(Object array,
                           int index)
                    throws IllegalArgumentException,
                           ArrayIndexOutOfBoundsException

指定された配列オブジェクトの指定されたインデックスのコンポーネント値を byte として返します。

パラメータ:: array - メッセージデータの長さ; index - インデックス
戻り値:: 指定された配列の指定されたインデックスのコンポーネント値
例外:: NullPointerException - 指定されたオブジェクトが null の場合; IllegalArgumentException - 指定されたオブジェクトが配列ではない場合、またはインデックスのコンポーネントを識別子または拡大変換によって戻り値の型に変換できない場合; ArrayIndexOutOfBoundsException - 指定された index 引数が負の場合、または指定された index 引数が指定された配列の長さ以上の場合
関連項目:: get(java.lang.Object, int)

getChar

public static char getChar(Object array,
                           int index)
                    throws IllegalArgumentException,
                           ArrayIndexOutOfBoundsException

指定された配列オブジェクトの指定されたインデックスのコンポーネント値を char として返します。

パラメータ:: array - メッセージデータの長さ; index - インデックス
戻り値:: 指定された配列の指定されたインデックスのコンポーネント値
例外:: NullPointerException - 指定されたオブジェクトが null の場合; IllegalArgumentException - 指定されたオブジェクトが配列ではない場合、またはインデックスのコンポーネントを識別子または拡大変換によって戻り値の型に変換できない場合; ArrayIndexOutOfBoundsException - 指定された index 引数が負の場合、または指定された index 引数が指定された配列の長さ以上の場合
関連項目:: get(java.lang.Object, int)

getShort

public static short getShort(Object array,
                             int index)
                      throws IllegalArgumentException,
                             ArrayIndexOutOfBoundsException

指定された配列オブジェクトの指定されたインデックスのコンポーネント値を short として返します。

パラメータ:: array - メッセージデータの長さ; index - インデックス
戻り値:: 指定された配列の指定されたインデックスのコンポーネント値
例外:: NullPointerException - 指定されたオブジェクトが null の場合; IllegalArgumentException - 指定されたオブジェクトが配列ではない場合、またはインデックスのコンポーネントを識別子または拡大変換によって戻り値の型に変換できない場合; ArrayIndexOutOfBoundsException - 指定された index 引数が負の場合、または指定された index 引数が指定された配列の長さ以上の場合
関連項目:: get(java.lang.Object, int)

getInt

public static int getInt(Object array,
                         int index)
                  throws IllegalArgumentException,
                         ArrayIndexOutOfBoundsException

指定された配列オブジェクト内の指定されたインデックスのコンポーネント値を int として返します。

パラメータ:: array - メッセージデータの長さ; index - インデックス
戻り値:: 指定された配列の指定されたインデックスのコンポーネント値
例外:: NullPointerException - 指定されたオブジェクトが null の場合; IllegalArgumentException - 指定されたオブジェクトが配列ではない場合、またはインデックスのコンポーネントを識別子または拡大変換によって戻り値の型に変換できない場合; ArrayIndexOutOfBoundsException - 指定された index 引数が負の場合、または指定された index 引数が指定された配列の長さ以上の場合
関連項目:: get(java.lang.Object, int)

getLong

public static long getLong(Object array,
                           int index)
                    throws IllegalArgumentException,
                           ArrayIndexOutOfBoundsException

指定された配列オブジェクトの指定されたインデックスのコンポーネント値を long として返します。

パラメータ:: array - メッセージデータの長さ; index - インデックス
戻り値:: 指定された配列の指定されたインデックスのコンポーネント値
例外:: NullPointerException - 指定されたオブジェクトが null の場合; IllegalArgumentException - 指定されたオブジェクトが配列ではない場合、またはインデックスのコンポーネントを識別子または拡大変換によって戻り値の型に変換できない場合; ArrayIndexOutOfBoundsException - 指定された index 引数が負の場合、または指定された index 引数が指定された配列の長さ以上の場合
関連項目:: get(java.lang.Object, int)

getFloat

public static float getFloat(Object array,
                             int index)
                      throws IllegalArgumentException,
                             ArrayIndexOutOfBoundsException

指定された配列オブジェクトの指定されたインデックスのコンポーネント値を float として返します。

パラメータ:: array - メッセージデータの長さ; index - インデックス
戻り値:: 指定された配列の指定されたインデックスのコンポーネント値
例外:: NullPointerException - 指定されたオブジェクトが null の場合; IllegalArgumentException - 指定されたオブジェクトが配列ではない場合、またはインデックスのコンポーネントを識別子または拡大変換によって戻り値の型に変換できない場合; ArrayIndexOutOfBoundsException - 指定された index 引数が負の場合、または指定された index 引数が指定された配列の長さ以上の場合
関連項目:: get(java.lang.Object, int)

getDouble

public static double getDouble(Object array,
                               int index)
                        throws IllegalArgumentException,
                               ArrayIndexOutOfBoundsException

指定された配列オブジェクトの指定されたインデックスのコンポーネント値を double として返します。

パラメータ:: array - メッセージデータの長さ; index - インデックス
戻り値:: 指定された配列の指定されたインデックスのコンポーネント値
例外:: NullPointerException - 指定されたオブジェクトが null の場合; IllegalArgumentException - 指定されたオブジェクトが配列ではない場合、またはインデックスのコンポーネントを識別子または拡大変換によって戻り値の型に変換できない場合; ArrayIndexOutOfBoundsException - 指定された index 引数が負の場合、または指定された index 引数が指定された配列の長さ以上の場合
関連項目:: get(java.lang.Object, int)

set

public static void set(Object array,
                       int index,
                       Object value)
                throws IllegalArgumentException,
                       ArrayIndexOutOfBoundsException

指定された配列オブジェクトのインデックス付きコンポーネントの値を、指定された新しい値に設定します。新しい値は、配列にプリミティブなコンポーネント型が指定されると、最初に自動的にラップ解除されます。

パラメータ:: array - メッセージデータの長さ; index - 配列の中のインデックス; value - 指定されたインデックスのコンポーネントの新しい値
例外:: NullPointerException - 指定されたオブジェクト引数が null の場合; IllegalArgumentException - 指定されたオブジェクト引数が配列でない場合、または配列のコンポーネント型がプリミティブであり、ラップ解除変換が失敗した場合; ArrayIndexOutOfBoundsException - 指定された index 引数が負の場合、または指定された index 引数が指定された配列の長さ以上の場合

setBoolean

public static void setBoolean(Object array,
                              int index,
                              boolean z)
                       throws IllegalArgumentException,
                              ArrayIndexOutOfBoundsException

指定された配列オブジェクトの指定されたインデックスのコンポーネント値を、指定された boolean 値に設定します。

パラメータ:: array - メッセージデータの長さ; index - 配列の中のインデックス; z - 指定されたインデックスのコンポーネントの新しい値
例外:: NullPointerException - 指定されたオブジェクト引数が null の場合; IllegalArgumentException - 指定されたオブジェクト引数が配列ではない場合、または指定された値を識別子またはプリミティブ拡大変換によって、基本となる配列のコンポーネント型に変換できない場合; ArrayIndexOutOfBoundsException - 指定された index 引数が負の場合、または指定された index 引数が指定された配列の長さ以上の場合
関連項目:: set(java.lang.Object, int, java.lang.Object)

setByte

public static void setByte(Object array,
                           int index,
                           byte b)
                    throws IllegalArgumentException,
                           ArrayIndexOutOfBoundsException

指定された配列オブジェクトの指定されたインデックスのコンポーネント値を、指定された byte 値に設定します。

パラメータ:: array - メッセージデータの長さ; index - 配列の中のインデックス; b - 指定されたインデックスのコンポーネントの新しい値
例外:: NullPointerException - 指定されたオブジェクト引数が null の場合; IllegalArgumentException - 指定されたオブジェクト引数が配列ではない場合、または指定された値を識別子またはプリミティブ拡大変換によって、基本となる配列のコンポーネント型に変換できない場合; ArrayIndexOutOfBoundsException - 指定された index 引数が負の場合、または指定された index 引数が指定された配列の長さ以上の場合
関連項目:: set(java.lang.Object, int, java.lang.Object)

setChar

public static void setChar(Object array,
                           int index,
                           char c)
                    throws IllegalArgumentException,
                           ArrayIndexOutOfBoundsException

指定された配列オブジェクトのインデックス化されたコンポーネント値を、指定された char 値に設定します。

パラメータ:: array - メッセージデータの長さ; index - 配列の中のインデックス; c - 指定されたインデックスのコンポーネントの新しい値
例外:: NullPointerException - 指定されたオブジェクト引数が null の場合; IllegalArgumentException - 指定されたオブジェクト引数が配列ではない場合、または指定された値を識別子またはプリミティブ拡大変換によって、基本となる配列のコンポーネント型に変換できない場合; ArrayIndexOutOfBoundsException - 指定された index 引数が負の場合、または指定された index 引数が指定された配列の長さ以上の場合
関連項目:: set(java.lang.Object, int, java.lang.Object)

setShort

public static void setShort(Object array,
                            int index,
                            short s)
                     throws IllegalArgumentException,
                            ArrayIndexOutOfBoundsException

指定された配列オブジェクトの指定されたインデックスのコンポーネントを、指定された short 値に設定します。

パラメータ:: array - メッセージデータの長さ; index - 配列の中のインデックス; s - 指定されたインデックスのコンポーネントの新しい値
例外:: NullPointerException - 指定されたオブジェクト引数が null の場合; IllegalArgumentException - 指定されたオブジェクト引数が配列ではない場合、または指定された値を識別子またはプリミティブ拡大変換によって、基本となる配列のコンポーネント型に変換できない場合; ArrayIndexOutOfBoundsException - 指定された index 引数が負の場合、または指定された index 引数が指定された配列の長さ以上の場合
関連項目:: set(java.lang.Object, int, java.lang.Object)

setInt

public static void setInt(Object array,
                          int index,
                          int i)
                   throws IllegalArgumentException,
                          ArrayIndexOutOfBoundsException

指定された配列オブジェクトの指定されたインデックスのコンポーネント値を、指定された int 値に設定します。

パラメータ:: array - メッセージデータの長さ; index - 配列の中のインデックス; i - 指定されたインデックスのコンポーネントの新しい値
例外:: NullPointerException - 指定されたオブジェクト引数が null の場合; IllegalArgumentException - 指定されたオブジェクト引数が配列ではない場合、または指定された値を識別子またはプリミティブ拡大変換によって、基本となる配列のコンポーネント型に変換できない場合; ArrayIndexOutOfBoundsException - 指定された index 引数が負の場合、または指定された index 引数が指定された配列の長さ以上の場合
関連項目:: set(java.lang.Object, int, java.lang.Object)

setLong

public static void setLong(Object array,
                           int index,
                           long l)
                    throws IllegalArgumentException,
                           ArrayIndexOutOfBoundsException

指定された配列オブジェクトの指定されたインデックスのコンポーネント値を、指定された long 値に設定します。

パラメータ:: array - メッセージデータの長さ; index - 配列の中のインデックス; l - 指定されたインデックスのコンポーネントの新しい値
例外:: NullPointerException - 指定されたオブジェクト引数が null の場合; IllegalArgumentException - 指定されたオブジェクト引数が配列ではない場合、または指定された値を識別子またはプリミティブ拡大変換によって、基本となる配列のコンポーネント型に変換できない場合; ArrayIndexOutOfBoundsException - 指定された index 引数が負の場合、または指定された index 引数が指定された配列の長さ以上の場合
関連項目:: set(java.lang.Object, int, java.lang.Object)

setFloat

public static void setFloat(Object array,
                            int index,
                            float f)
                     throws IllegalArgumentException,
                            ArrayIndexOutOfBoundsException

指定された配列オブジェクトの指定されたインデックスのコンポーネント値を、指定された float 値に設定します。

パラメータ:: array - メッセージデータの長さ; index - 配列の中のインデックス; f - 指定されたインデックスのコンポーネントの新しい値
例外:: NullPointerException - 指定されたオブジェクト引数が null の場合; IllegalArgumentException - 指定されたオブジェクト引数が配列ではない場合、または指定された値を識別子またはプリミティブ拡大変換によって、基本となる配列のコンポーネント型に変換できない場合; ArrayIndexOutOfBoundsException - 指定された index 引数が負の場合、または指定された index 引数が指定された配列の長さ以上の場合
関連項目:: set(java.lang.Object, int, java.lang.Object)

setDouble

public static void setDouble(Object array,
                             int index,
                             double d)
                      throws IllegalArgumentException,
                             ArrayIndexOutOfBoundsException

指定された配列オブジェクトの指定されたインデックスのコンポーネント値を、指定された double 値に設定します。

パラメータ:: array - メッセージデータの長さ; index - 配列の中のインデックス; d - 指定されたインデックスのコンポーネントの新しい値
例外:: NullPointerException - 指定されたオブジェクト引数が null の場合; IllegalArgumentException - 指定されたオブジェクト引数が配列ではない場合、または指定された値を識別子またはプリミティブ拡大変換によって、基本となる配列のコンポーネント型に変換できない場合; ArrayIndexOutOfBoundsException - 指定された index 引数が負の場合、または指定された index 引数が指定された配列の長さ以上の場合
関連項目:: set(java.lang.Object, int, java.lang.Object)