Array (Java 2 プラットフォーム SE v1.4.0)

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM 2
Platform
Std. Ed. v1.4.0

前のクラス 次のクラス

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

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

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

java.lang.reflect
クラス Array

java.lang.Object
  |
  +--java.lang.reflect.Array

public final class Array
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 length)
          指定されたコンポーネント型とコンポーネントサイズを使用して新しい配列を作成します。

static Object newInstance(Class componentType, int[] dimensions)
          指定されたコンポーネント型と大きさで新しい配列を作成します。

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 の場合、または配列のコンポーネント型がプリミティブであり、指定値が 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)

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM 2
Platform
Std. Ed. v1.4.0

前のクラス 次のクラス

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

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

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

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

メソッドの概要
`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 length)` 指定されたコンポーネント型とコンポーネントサイズを使用して新しい配列を作成します。
`static Object`	`newInstance(Class componentType, int[] dimensions)` 指定されたコンポーネント型と大きさで新しい配列を作成します。
`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.reflect クラス Array

newInstance

newInstance

getLength

get

getBoolean

getByte

getChar

getShort

getInt

getLong

getFloat

getDouble

set

setBoolean

setByte

setChar

setShort

setInt

setLong

setFloat

setDouble

java.lang.reflect
クラス Array