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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект другому объекту.
`protected void`	`finalize()`	Устарело, подлежит удалению: этот элемент API может быть удален в будущей версии. Финализация устарела и может быть удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Переводит текущий поток в состояние ожидания до его пробуждения, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в состояние ожидания до его пробуждения, обычно посредством уведомления или прерывания, либо до истечения указанного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в состояние ожидания до его пробуждения, обычно посредством уведомления или прерывания, либо до истечения указанного промежутка реального времени.

Подробное описание методов

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 или dimensions равен null; IllegalArgumentException — если указанный аргумент dimensions является массивом нулевого измерения, если componentType равен Void.TYPE или число измерений запрошенного экземпляра массива превышает 255.; NegativeArraySizeException — если любой из компонентов указанного аргумента dimensions отрицателен.

getLength

public static int getLength(Object array) throws IllegalArgumentException

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

Параметры:: array — массив
Возвращает:: длину массива
Исключения:: NullPointerException — если array равно null; IllegalArgumentException — если array не является массивом

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 — если указанный аргумент-объект равен null; IllegalArgumentException — если указанный аргумент-объект не является массивом или если тип компонентов массива примитивный и распаковка завершается неудачей; ArrayIndexOutOfBoundsException — если указанный аргумент index отрицателен или больше либо равен длине указанного массива

setBoolean

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

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

Параметры:

array — массив

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

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

Исключения:

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

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

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

См. также:

setByte

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

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

Параметры:

array — массив

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

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

Исключения:

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

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

См. также:

setChar

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

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

Параметры:

array — массив

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

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

Исключения:

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

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

См. также:

setShort

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

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

Параметры:

array — массив

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

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

Исключения:

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

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

См. также:

setInt

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

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

Параметры:

array — массив

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

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

Исключения:

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

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

См. также:

setLong

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

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

Параметры:

array — массив

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

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

Исключения:

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

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

См. также:

setFloat

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

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

Параметры:

array — массив

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

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

Исключения:

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

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

См. также:

setDouble

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

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

Параметры:

array — массив

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

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

Исключения:

NullPointerException — если указанный аргумент-объект равен 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.