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

getBoolean

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

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

Параметры:

array - массив

index - индекс

Возвращает:

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

Исключения:

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

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

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

См. также:

get(java.lang.Object, int)

getByte

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

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

Параметры:

array - массив

index - индекс

Возвращает:

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

Исключения:

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

См. также:

get(java.lang.Object, int)

getChar

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

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

Параметры:

array - массив

index - индекс

Возвращает:

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

Исключения:

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

См. также:

get(java.lang.Object, int)

getShort

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

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

Параметры:

array - массив

index - индекс

Возвращает:

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

Исключения:

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

См. также:

get(java.lang.Object, int)

getInt

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

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

Параметры:

array - массив

index - индекс

Возвращает:

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

Исключения:

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

См. также:

get(java.lang.Object, int)

getLong

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

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

Параметры:

array - массив

index - индекс

Возвращает:

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

Исключения:

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

См. также:

get(java.lang.Object, int)

getFloat

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

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

Параметры:

array - массив

index - индекс

Возвращает:

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

Исключения:

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

См. также:

get(java.lang.Object, int)

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:

get(java.lang.Object, int)

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

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

Parameters:

array - массив

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

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

Throws:

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

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

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

See Also:

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

setByte

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

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

Parameters:

array - массив

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

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

Throws:

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

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

See Also:

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

setChar

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

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

Parameters:

array - массив

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

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

Throws:

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

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

See Also:

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

setShort

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

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

Parameters:

array - массив

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

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

Throws:

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

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

See Also:

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

setInt

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

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

Parameters:

array - массив

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

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

Throws:

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

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

See Also:

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

setLong

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

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

Parameters:

array - массив

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

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

Throws:

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

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

See Also:

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

setFloat

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

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

Parameters:

array - массив

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

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

Throws:

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

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

See Also:

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

setDouble

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

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

Parameters:

array - массив

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

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

Throws:

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

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

See Also:

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

© 1993, 2021, 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/17/docs/api/java.base/java/lang/reflect/Array.html