Класс Array

java.lang.Object
- java.lang.reflect.Array

public final class Array
extends Object

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

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

Методы

Модификатор и тип	Метод и описание
`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... dimensions)` Создаёт новый массив со специфицированным типом компонента и размерностями.
`static Object`	`newInstance(Class<?> componentType, int length)` Создаёт новый массив со специфицированным типом компонента и длиной.
`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 - если аргумент 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 отрицателен или больше или равен длине указанного массива
См. также:: get(java.lang.Object, int)

getByte

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

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

Параметры:: array - массив; index - индекс
Возвращает:: значение индексированного компонента в указанном массиве
Исключения:: NullPointerException - если указанный объект равен null; IllegalArgumentException - если указанный объект не является массивом или если индексированный элемент не может быть преобразован в тип возвращаемого значения с помощью тождественного или расширяющего преобразования; ArrayIndexOutOfBoundsException - если указанный аргумент index отрицателен или больше или равен длине указанного массива
См. также:: get(java.lang.Object, int)

getChar

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

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

Параметры:: array - массив; index - индекс
Возвращает:: значение индексированного компонента в указанном массиве
Исключения:: NullPointerException - если указанный объект равен null; IllegalArgumentException - если указанный объект не является массивом или если индексированный элемент не может быть преобразован в тип возвращаемого значения с помощью тождественного или расширяющего преобразования; ArrayIndexOutOfBoundsException - если указанный аргумент index отрицателен или больше или равен длине указанного массива
См. также:: get(java.lang.Object, int)

getShort

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

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

Параметры:: array - массив; index - индекс
Возвращает:: значение индексированного компонента в указанном массиве
Исключения:: NullPointerException - если указанный объект равен null; IllegalArgumentException - если указанный объект не является массивом или если индексированный элемент не может быть преобразован в тип возвращаемого значения с помощью тождественного или расширяющего преобразования; ArrayIndexOutOfBoundsException - если указанный аргумент index отрицателен или больше или равен длине указанного массива
См. также:: get(java.lang.Object, int)

getInt

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

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

Параметры:: array - массив; index - индекс
Возвращает:: значение индексированного компонента в указанном массиве
Исключения:: NullPointerException - если указанный объект равен null; IllegalArgumentException - если указанный объект не является массивом или если индексированный элемент не может быть преобразован в тип возвращаемого значения с помощью тождественного или расширяющего преобразования; ArrayIndexOutOfBoundsException - если указанный аргумент index отрицателен или больше или равен длине указанного массива
См. также:: get(java.lang.Object, int)

getLong

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

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

Параметры:: array - массив; index - индекс
Возвращает:: значение индексированного компонента в указанном массиве
Исключения:: NullPointerException - если указанный объект равен null; IllegalArgumentException - если указанный объект не является массивом или если индексированный элемент не может быть преобразован в тип возвращаемого значения с помощью тождественного или расширяющего преобразования; ArrayIndexOutOfBoundsException - если указанный аргумент index отрицателен или больше или равен длине указанного массива
См. также:: get(java.lang.Object, int)

getFloat

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

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

Параметры:: array - массив; index - индекс
Возвращает:: значение индексированного компонента в указанном массиве
Исключения:: NullPointerException - если указанный объект равен null; IllegalArgumentException - если указанный объект не является массивом или если индексированный элемент не может быть преобразован в тип возвращаемого значения с помощью тождественного или расширяющего преобразования; ArrayIndexOutOfBoundsException - если указанный аргумент index отрицателен или больше или равен длине указанного массива
См. также:: get(java.lang.Object, int)

getDouble

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

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

Параметры:: array - массив; index - индекс
Возвращает:: значение индексированного компонента в указанном массиве
Исключения:: NullPointerException - если указанный объект равен null; IllegalArgumentException - если указанный объект не является массивом или если индексированный элемент не может быть преобразован в тип возвращаемого значения с помощью тождественного или расширяющего преобразования; ArrayIndexOutOfBoundsException - если указанный аргумент index отрицателен или больше или равен длине указанного массива
См. также:: get(java.lang.Object, int)

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 отрицательный или если он больше или равен длине указанного массива
См. также:: set(java.lang.Object, int, java.lang.Object)

setByte

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

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

Параметры:: array - массив; index - индекс в массиве; b - новое значение индексированного компонента
Исключения:: NullPointerException - Если указанный аргумент объекта равен null; IllegalArgumentException - Если указанный аргумент объекта не является массивом или если указанное значение не может быть преобразовано в базовый тип компонента массива с помощью преобразования тождества или расширения примитивного типа; ArrayIndexOutOfBoundsException - Если указанный аргумент index отрицательный или если он больше или равен длине указанного массива
См. также:: set(java.lang.Object, int, java.lang.Object)

setChar

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

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

Параметры:: array - массив; index - индекс в массиве; c - новое значение индексированного компонента
Исключения:: NullPointerException - Если указанный аргумент объекта равен null; IllegalArgumentException - Если указанный аргумент объекта не является массивом или если указанное значение не может быть преобразовано в базовый тип компонента массива с помощью преобразования тождества или расширения примитивного типа; ArrayIndexOutOfBoundsException - Если указанный аргумент index отрицательный или если он больше или равен длине указанного массива
См. также:: set(java.lang.Object, int, java.lang.Object)

setShort

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

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

Параметры:: array - массив; index - индекс в массиве; s - новое значение индексированного компонента
Исключения:: NullPointerException - Если указанный аргумент объекта равен null; IllegalArgumentException - Если указанный аргумент объекта не является массивом или если указанное значение не может быть преобразовано в базовый тип компонента массива с помощью преобразования тождества или расширения примитивного типа; ArrayIndexOutOfBoundsException - Если указанный аргумент index отрицательный или если он больше или равен длине указанного массива
См. также:: set(java.lang.Object, int, java.lang.Object)

setInt

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

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

Параметры:: array - массив; index - индекс в массиве; i - новое значение индексированного компонента
Исключения:: NullPointerException - Если указанный аргумент объекта равен null; IllegalArgumentException - Если указанный аргумент объекта не является массивом или если указанное значение не может быть преобразовано в базовый тип компонента массива с помощью преобразования тождества или расширения примитивного типа; ArrayIndexOutOfBoundsException - Если указанный аргумент index отрицательный или если он больше или равен длине указанного массива
См. также:: set(java.lang.Object, int, java.lang.Object)

setLong

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

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

Параметры:: array - массив; index - индекс в массиве; l - новое значение индексированного компонента
Исключения:: NullPointerException - Если указанный аргумент объекта равен null; IllegalArgumentException - Если указанный аргумент объекта не является массивом или если указанное значение не может быть преобразовано в базовый тип компонента массива с помощью преобразования тождества или расширения примитивного типа; ArrayIndexOutOfBoundsException - Если указанный аргумент index отрицательный или если он больше или равен длине указанного массива
См. также:: set(java.lang.Object, int, java.lang.Object)

setFloat

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

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

Параметры:: array - массив; index - индекс в массиве; f - новое значение индексированного компонента
Исключения:: NullPointerException - Если указанный аргумент объекта равен null; IllegalArgumentException - Если указанный аргумент объекта не является массивом или если указанное значение не может быть преобразовано в базовый тип компонента массива с помощью преобразования тождества или расширения примитивного типа; ArrayIndexOutOfBoundsException - Если указанный аргумент index отрицательный или если он больше или равен длине указанного массива
См. также:: set(java.lang.Object, int, java.lang.Object)

setDouble

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

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

Параметры:: array - массив; index - индекс в массиве; d - новое значение индексированного компонента
Исключения:: NullPointerException - Если указанный аргумент объекта равен null; IllegalArgumentException - Если указанный аргумент объекта не является массивом или если указанное значение не может быть преобразовано в базовый тип компонента массива с помощью преобразования тождества или расширения примитивного типа; ArrayIndexOutOfBoundsException - Если указанный аргумент index отрицательный или если он больше или равен длине указанного массива
См. также:: set(java.lang.Object, int, java.lang.Object)

© 1993, 2020, 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.