Класс Array

java.lang.Object

java.lang.reflect.Array

public final class Array extends Object

Класс Array предоставляет статические методы для динамического создания и доступа к массивам Java.

Array допускает расширяющие преобразования при операции get или set, но выводит IllegalArgumentException при выполнении сужающего преобразования.

С момента:: 1.1

Краткое описание методов

Модификатор и тип	Метод	Описание
`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);

Количество измерений нового массива не должно превышать 255.

Параметры:: componentType - объект Class, представляющий тип компонента нового массива; length - длина нового массива
Возвращаемое значение:: новый массив
Исключения:: NullPointerException - если указанный параметр componentType равен null; IllegalArgumentException - если componentType равен Void.TYPE или если количество измерений запрошенной инстанции массива превышает 255.; 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 представляет нульмерный массив, если componentType равен Void.TYPE, или если количество измерений запрошенной инстанции массива превышает 255.; 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 отрицателен или больше или равен длине указанного массива

getBoolean

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

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

Параметры:

array - массив

index - индекс

Возвращаемое значение:

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

Исключения:

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

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

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

См. также:

getByte

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

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

Параметры:

array - массив

index - индекс

Возвращаемое значение:

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

Исключения:

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

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

См. также:

getChar

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

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

Параметры:

array - массив

index - индекс

Возвращаемое значение:

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

Исключения:

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

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

См. также:

getShort

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

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

Параметры:

array - массив

index - индекс

Возвращаемое значение:

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

Исключения:

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

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

См. также:

getInt

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

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

Параметры:

array - массив

index - индекс

Возвращаемое значение:

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

Исключения:

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

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

См. также:

getLong

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

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

Параметры:

array - массив

index - индекс

Возвращаемое значение:

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

Исключения:

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

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

См. также:

getFloat

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

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

Параметры:

array - массив

index - индекс

Возвращаемое значение:

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

Исключения:

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

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

См. также:

getDouble

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

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

Parameters:

array - массив

index - индекс

Returns:

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

Throws:

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

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

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

See Also:

set

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

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

Parameters:: array - массив; index - индекс в массиве; value - новое значение индексированного компонента
Throws:: NullPointerException - Если указанный аргумент объекта равен null; IllegalArgumentException - Если указанный аргумент объекта не является массивом или если тип компонента массива является примитивным, и преобразование распаковки завершается ошибкой; ArrayIndexOutOfBoundsException - Если указанный аргумент index отрицательный или больше или равен длине указанного массива

setBoolean

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

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

Parameters:

array - массив

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

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

Throws:

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

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

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

See Also:

setByte

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

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

Parameters:

array - массив

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

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

Throws:

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

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

See Also:

setChar

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

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

Parameters:

array - массив

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

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

Throws:

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

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

See Also:

setShort

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

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

Parameters:

array - массив

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

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

Throws:

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

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

See Also:

setInt

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

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

Parameters:

array - массив

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

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

Throws:

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

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

See Also:

setLong

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

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

Parameters:

array - массив

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

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

Throws:

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

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

See Also:

setFloat

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

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

Parameters:

array - массив

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

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

Throws:

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

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

See Also:

setDouble

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

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

Parameters:

array - массив

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

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

Throws:

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

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

See Also:

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/reflect/Array.html