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인 경우

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)