Класс 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

Создает новый массив с указанным типом компонента и длиной.

Требования к реализации:: Вызов этого метода эквивалентен созданию массива следующим образом:
Array.newInstance(componentType, new int[]{length});

Количество измерений нового массива не должно превышать 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 - если аргумент object не является массивом

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.

Parameters:

array - массив

index - индекс

Returns:

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

Throws:

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

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

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

See Also:

getDouble

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

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

Parameters:

array - массив

index - индекс

Returns:

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

Throws:

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

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 - Если указанный аргумент индекса отрицательный или больше или равен длине указанного массива

setBoolean

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

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

Parameters:

array - массив

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

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

Throws:

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

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

See Also:

setByte

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

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

Parameters:

array - массив

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

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

Throws:

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

See Also:

setChar

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

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

Parameters:

array - массив

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

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

Throws:

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

See Also:

setShort

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

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

Parameters:

array - массив

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

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

Throws:

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

See Also:

setInt

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

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

Parameters:

array - массив

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

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

Throws:

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

See Also:

setLong

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

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

Parameters:

array - массив

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

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

Throws:

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

See Also:

setFloat

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

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

Parameters:

array - массив

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

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

Throws:

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

See Also:

setDouble

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

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

Параметры:

array - массив

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

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

Исключения:

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

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

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

См. также:

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/lang/reflect/Array.html