JavaTM Platform
Standard Ed. 6

java.lang.reflect
클래스 Array

java.lang.Object 
  상위를 확장 java.lang.reflect.Array


public final class Array
extends Object

Array 클래스는, Java 배열을 동적으로 작성해 액세스하기 위한 static 메소드를 제공합니다.

Array 는, 취득 동작 또는 설정 동작중에 일어나는 확대 변환은 허가합니다만, 축소 변환이 일어나면(자) IllegalArgumentException 가 throw 됩니다.


메소드의 개요
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.lengthcomponentType 의 차원수의 합계입니다. 이 경우, 새로운 배열의 컴퍼넌트형은 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 
지정된 배열 객체의 인덱스 첨부 컴퍼넌트의 값을, 지정된 새로운 값으로 설정합니다. 새로운 값은, 배열에 프리미티브(primitive)인 컴퍼넌트형이 지정되면(자), 최초로 자동적으로 랩 해제됩니다.

파라미터:
array - 배열
index - 배열안의 인덱스
value - 지정된 인덱스의 컴퍼넌트의 새로운 값
예외:
NullPointerException - 지정된 객체 인수가 null 의 경우
IllegalArgumentException - 지정된 객체 인수가 배열이 아닌 경우, 또는 배열의 컴퍼넌트형이 프리미티브(primitive)이고, 랩 해제 변환이 실패했을 경우
ArrayIndexOutOfBoundsException - 지정된 index 인수가 부의 경우, 또는 지정된 index 인수가 지정된 배열의 길이 이상의 경우

setBoolean

public static void setBoolean(Object  array,
                              int index,
                              boolean z)
                       throws IllegalArgumentException ,
                              ArrayIndexOutOfBoundsException 
지정된 배열 객체의 지정된 인덱스의 컴퍼넌트치를, 지정된 boolean 치로 설정합니다.

파라미터:
array - 배열
index - 배열안의 인덱스
z - 지정된 인덱스의 컴퍼넌트의 새로운 값
예외:
NullPointerException - 지정된 객체 인수가 null 의 경우
IllegalArgumentException - 지정된 객체 인수가 배열이 아닌 경우, 또는 지정된 값을 식별자 또는 프리미티브(primitive) 확대 변환에 의해, 기본이 되는 배열의 컴퍼넌트형으로 변환할 수 없는 경우
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 - 지정된 객체 인수가 배열이 아닌 경우, 또는 지정된 값을 식별자 또는 프리미티브(primitive) 확대 변환에 의해, 기본이 되는 배열의 컴퍼넌트형으로 변환할 수 없는 경우
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 - 지정된 객체 인수가 배열이 아닌 경우, 또는 지정된 값을 식별자 또는 프리미티브(primitive) 확대 변환에 의해, 기본이 되는 배열의 컴퍼넌트형으로 변환할 수 없는 경우
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 - 지정된 객체 인수가 배열이 아닌 경우, 또는 지정된 값을 식별자 또는 프리미티브(primitive) 확대 변환에 의해, 기본이 되는 배열의 컴퍼넌트형으로 변환할 수 없는 경우
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 - 지정된 객체 인수가 배열이 아닌 경우, 또는 지정된 값을 식별자 또는 프리미티브(primitive) 확대 변환에 의해, 기본이 되는 배열의 컴퍼넌트형으로 변환할 수 없는 경우
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 - 지정된 객체 인수가 배열이 아닌 경우, 또는 지정된 값을 식별자 또는 프리미티브(primitive) 확대 변환에 의해, 기본이 되는 배열의 컴퍼넌트형으로 변환할 수 없는 경우
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 - 지정된 객체 인수가 배열이 아닌 경우, 또는 지정된 값을 식별자 또는 프리미티브(primitive) 확대 변환에 의해, 기본이 되는 배열의 컴퍼넌트형으로 변환할 수 없는 경우
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 - 지정된 객체 인수가 배열이 아닌 경우, 또는 지정된 값을 식별자 또는 프리미티브(primitive) 확대 변환에 의해, 기본이 되는 배열의 컴퍼넌트형으로 변환할 수 없는 경우
ArrayIndexOutOfBoundsException - 지정된 index 인수가 부의 경우, 또는 지정된 index 인수가 지정된 배열의 길이 이상의 경우
관련 항목:
set(java.lang.Object, int, java.lang.Object)

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 도 참조해 주세요.