Класс Array

java.lang.Object

java.lang.reflect.Array

public final class Array extends Object

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

Array допускает выполнение расширяющих преобразований при операциях получения или установки значения, но выбрасывает 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`.

Методы, объявленные в классе 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.

Параметры:

array — массив

index — индекс

Возвращает:

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

Выбрасывает:

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

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

См. также:

getDouble

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

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

Параметры:

array — массив

index — индекс

Возвращает:

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

Выбрасывает:

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

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

См. также:

set

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

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

Параметры:: array — массив; index — индекс в массиве; value — новое значение компонента с указанным индексом
Выбрасывает:: NullPointerException — если указанный аргумент object равен null; IllegalArgumentException — если указанный аргумент object не является массивом или если тип компонента массива является примитивным и распаковка завершается неудачей; ArrayIndexOutOfBoundsException — если указанный аргумент index отрицателен или больше либо равен длине указанного массива

setBoolean

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

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

Параметры:

array — массив

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

z — новое значение компонента с указанным индексом

Выбрасывает:

NullPointerException — если указанный аргумент object равен null

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

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

См. также:

setByte

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

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

Параметры:

array — массив

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

b — новое значение компонента с указанным индексом

Выбрасывает:

NullPointerException — если указанный аргумент object равен null

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

См. также:

setChar

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

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

Параметры:

array — массив

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

c — новое значение компонента с указанным индексом

Выбрасывает:

NullPointerException — если указанный аргумент object равен null

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

См. также:

setShort

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

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

Параметры:

array — массив

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

s — новое значение компонента с указанным индексом

Выбрасывает:

NullPointerException — если указанный аргумент object равен null

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

См. также:

setInt

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

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

Параметры:

array — массив

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

i — новое значение компонента с указанным индексом

Выбрасывает:

NullPointerException — если указанный аргумент object равен null

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

См. также:

setLong

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

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

Параметры:

array — массив

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

l — новое значение компонента с указанным индексом

Выбрасывает:

NullPointerException — если указанный аргумент object равен null

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

См. также:

setFloat

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

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

Параметры:

array — массив

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

f — новое значение компонента с указанным индексом

Выбрасывает:

NullPointerException — если указанный аргумент object равен null

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

См. также:

setDouble

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

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

Параметры:

array — массив

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

d — новое значение компонента с указанным индексом

Выбрасывает:

NullPointerException — если указанный аргумент object равен null

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://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/lang/reflect/Array.html