java.lang.reflect

Массив класса

java.lang. Объект

java.lang.reflect. Массив

public final class Array
extends Object

Array класс обеспечивает статические методы, чтобы динамически создать и получить доступ к массивам Java.

Array разрешения, расширяющие преобразования, чтобы произойти во время того, чтобы получать или операции присвоения, но бросков IllegalArgumentException если сужающееся преобразование произошло бы.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
static Object	get(Object array, int index) Возвращает значение индексированного компонента в указанном объекте массива.
static boolean	getBoolean(Object array, int index) Возвращает значение индексированного компонента в указанном объекте массива, как a boolean.
static byte	getByte(Object array, int index) Возвращает значение индексированного компонента в указанном объекте массива, как a byte.
static char	getChar(Object array, int index) Возвращает значение индексированного компонента в указанном объекте массива, как a char.
static double	getDouble(Object array, int index) Возвращает значение индексированного компонента в указанном объекте массива, как a double.
static float	getFloat(Object array, int index) Возвращает значение индексированного компонента в указанном объекте массива, как a float.
static int	getInt(Object array, int index) Возвращает значение индексированного компонента в указанном объекте массива, как int.
static int	getLength(Object array) Возвращает длину указанного объекта массива, как int.
static long	getLong(Object array, int index) Возвращает значение индексированного компонента в указанном объекте массива, как a long.
static short	getShort(Object array, int index) Возвращает значение индексированного компонента в указанном объекте массива, как a 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 унаследованный от класса. Объект

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 параметр является нулем

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 параметром является нуль

IllegalArgumentException - если указанное dimensions параметром является массив нулевой размерности, или если число требуемых размерностей превышает предел на числе размерностей массива, поддерживаемых реализацией (обычно 255), или если componentType Void.TYPE.

NegativeArraySizeException - если любой из компонентов в указанном dimensions параметр отрицателен.

getLength

public static int getLength(Object array)
                     throws IllegalArgumentException

Возвращает длину указанного объекта массива, как int.

Параметры:

array - массив

Возвраты:

длина массива

Броски:

IllegalArgumentException - если объектным параметром не является массив

добраться

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

Возвращает значение индексированного компонента в указанном объекте массива. Значение автоматически обертывается в объект, если у него есть тип примитива.

Параметры:

array - массив

index - индекс

Возвраты:

(возможно обернутый) значение индексированного компонента в указанном массиве

Броски:

NullPointerException - Если указанный объект является нулем

IllegalArgumentException - Если указанный объект не является массивом

ArrayIndexOutOfBoundsException - Если указанное index параметр отрицателен, или если это больше чем или равно длине указанного массива

getBoolean

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

Возвращает значение индексированного компонента в указанном объекте массива, как a boolean.

Параметры:

array - массив

index - индекс

Возвраты:

значение индексированного компонента в указанном массиве

Броски:

NullPointerException - Если указанный объект является нулем

IllegalArgumentException - Если указанный объект не является массивом, или если индексированный элемент не может быть преобразован в тип возврата идентификационными данными или расширяющимся преобразованием

ArrayIndexOutOfBoundsException - Если указанное index параметр отрицателен, или если это больше чем или равно длине указанного массива

См. Также:

get(java.lang.Object, int)

getByte

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

Возвращает значение индексированного компонента в указанном объекте массива, как a byte.

Параметры:

array - массив

index - индекс

Возвраты:

значение индексированного компонента в указанном массиве

Броски:

NullPointerException - Если указанный объект является нулем

IllegalArgumentException - Если указанный объект не является массивом, или если индексированный элемент не может быть преобразован в тип возврата идентификационными данными или расширяющимся преобразованием

ArrayIndexOutOfBoundsException - Если указанное index параметр отрицателен, или если это больше чем или равно длине указанного массива

См. Также:

get(java.lang.Object, int)

getChar

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

Возвращает значение индексированного компонента в указанном объекте массива, как a char.

Параметры:

array - массив

index - индекс

Возвраты:

значение индексированного компонента в указанном массиве

Броски:

NullPointerException - Если указанный объект является нулем

IllegalArgumentException - Если указанный объект не является массивом, или если индексированный элемент не может быть преобразован в тип возврата идентификационными данными или расширяющимся преобразованием

ArrayIndexOutOfBoundsException - Если указанное index параметр отрицателен, или если это больше чем или равно длине указанного массива

См. Также:

get(java.lang.Object, int)

getShort

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

Возвращает значение индексированного компонента в указанном объекте массива, как a short.

Параметры:

array - массив

index - индекс

Возвраты:

значение индексированного компонента в указанном массиве

Броски:

NullPointerException - Если указанный объект является нулем

IllegalArgumentException - Если указанный объект не является массивом, или если индексированный элемент не может быть преобразован в тип возврата идентификационными данными или расширяющимся преобразованием

ArrayIndexOutOfBoundsException - Если указанное index параметр отрицателен, или если это больше чем или равно длине указанного массива

См. Также:

get(java.lang.Object, int)

getInt

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

Возвращает значение индексированного компонента в указанном объекте массива, как int.

Параметры:

array - массив

index - индекс

Возвраты:

значение индексированного компонента в указанном массиве

Броски:

NullPointerException - Если указанный объект является нулем

IllegalArgumentException - Если указанный объект не является массивом, или если индексированный элемент не может быть преобразован в тип возврата идентификационными данными или расширяющимся преобразованием

ArrayIndexOutOfBoundsException - Если указанное index параметр отрицателен, или если это больше чем или равно длине указанного массива

См. Также:

get(java.lang.Object, int)

getLong

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

Возвращает значение индексированного компонента в указанном объекте массива, как a long.

Параметры:

array - массив

index - индекс

Возвраты:

значение индексированного компонента в указанном массиве

Броски:

NullPointerException - Если указанный объект является нулем

IllegalArgumentException - Если указанный объект не является массивом, или если индексированный элемент не может быть преобразован в тип возврата идентификационными данными или расширяющимся преобразованием

ArrayIndexOutOfBoundsException - Если указанное index параметр отрицателен, или если это больше чем или равно длине указанного массива

См. Также:

get(java.lang.Object, int)

getFloat

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

Возвращает значение индексированного компонента в указанном объекте массива, как a float.

Параметры:

array - массив

index - индекс

Возвраты:

значение индексированного компонента в указанном массиве

Броски:

NullPointerException - Если указанный объект является нулем

IllegalArgumentException - Если указанный объект не является массивом, или если индексированный элемент не может быть преобразован в тип возврата идентификационными данными или расширяющимся преобразованием

ArrayIndexOutOfBoundsException - Если указанное index параметр отрицателен, или если это больше чем или равно длине указанного массива

См. Также:

get(java.lang.Object, int)

getDouble

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

Возвращает значение индексированного компонента в указанном объекте массива, как a double.

Параметры:

array - массив

index - индекс

Возвраты:

значение индексированного компонента в указанном массиве

Броски:

NullPointerException - Если указанный объект является нулем

IllegalArgumentException - Если указанный объект не является массивом, или если индексированный элемент не может быть преобразован в тип возврата идентификационными данными или расширяющимся преобразованием

ArrayIndexOutOfBoundsException - Если указанное index параметр отрицателен, или если это больше чем или равно длине указанного массива

См. Также:

get(java.lang.Object, int)

набор

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

Устанавливает значение индексированного компонента указанного объекта массива к указанному новому значению. Новое значение сначала автоматически разворачивается, если у массива есть тип примитива.

Параметры:

array - массив

index - индекс в массив

value - новое значение индексированного компонента

Броски:

NullPointerException - Если указанным объектным параметром является нуль

IllegalArgumentException - Если указанным объектным параметром не является массив, или если компонентный тип массива примитивен, и преобразование разворачивания перестало работать

ArrayIndexOutOfBoundsException - Если указанное index параметр отрицателен, или если это больше чем или равно длине указанного массива

setBoolean

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

Устанавливает значение индексированного компонента указанного объекта массива к указанному boolean значение.

Параметры:

array - массив

index - индекс в массив

z - новое значение индексированного компонента

Броски:

NullPointerException - Если указанным объектным параметром является нуль

IllegalArgumentException - Если указанным объектным параметром не является массив, или если указанное значение не может быть преобразовано в компонентный тип базового массива идентификационными данными или примитивным расширяющимся преобразованием

ArrayIndexOutOfBoundsException - Если указанное 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 - Если указанным объектным параметром является нуль

IllegalArgumentException - Если указанным объектным параметром не является массив, или если указанное значение не может быть преобразовано в компонентный тип базового массива идентификационными данными или примитивным расширяющимся преобразованием

ArrayIndexOutOfBoundsException - Если указанное 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 - Если указанным объектным параметром является нуль

IllegalArgumentException - Если указанным объектным параметром не является массив, или если указанное значение не может быть преобразовано в компонентный тип базового массива идентификационными данными или примитивным расширяющимся преобразованием

ArrayIndexOutOfBoundsException - Если указанное 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 - Если указанным объектным параметром является нуль

IllegalArgumentException - Если указанным объектным параметром не является массив, или если указанное значение не может быть преобразовано в компонентный тип базового массива идентификационными данными или примитивным расширяющимся преобразованием

ArrayIndexOutOfBoundsException - Если указанное 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 - Если указанным объектным параметром является нуль

IllegalArgumentException - Если указанным объектным параметром не является массив, или если указанное значение не может быть преобразовано в компонентный тип базового массива идентификационными данными или примитивным расширяющимся преобразованием

ArrayIndexOutOfBoundsException - Если указанное 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 - Если указанным объектным параметром является нуль

IllegalArgumentException - Если указанным объектным параметром не является массив, или если указанное значение не может быть преобразовано в компонентный тип базового массива идентификационными данными или примитивным расширяющимся преобразованием

ArrayIndexOutOfBoundsException - Если указанное 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 - Если указанным объектным параметром является нуль

IllegalArgumentException - Если указанным объектным параметром не является массив, или если указанное значение не может быть преобразовано в компонентный тип базового массива идентификационными данными или примитивным расширяющимся преобразованием

ArrayIndexOutOfBoundsException - Если указанное 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 - Если указанным объектным параметром является нуль

IllegalArgumentException - Если указанным объектным параметром не является массив, или если указанное значение не может быть преобразовано в компонентный тип базового массива идентификационными данными или примитивным расширяющимся преобразованием

ArrayIndexOutOfBoundsException - Если указанное index параметр отрицателен, или если это больше чем или равно длине указанного массива

См. Также:

set(java.lang.Object, int, java.lang.Object)