Класс Array

public final class Array
extends Object

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

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

Since:
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 - объект, представляющий тип компонента нового массива
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 - объект, представляющий тип компонента нового массива
dimensions - массив, представляющий размеры нового массива
Возвращает:
новый массив
Исключения:
NullPointerException - если указанный параметр componentType равен null
IllegalArgumentException - если указанный параметр dimensions представляет нульмерный массив, если componentType равен Void.TYPE, или если количество измерений запрашиваемого экземпляра массива превышает 255.
NegativeArraySizeException - если любой из компонентов в указанном параметре dimensions отрицательный.

getLength

public static int getLength(Object array)
                     throws IllegalArgumentException

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

Параметры:
array - массив
Возвращает:
длину массива
Исключения:
IllegalArgumentException - если объект-аргумент не является массивом

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

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

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

getByte

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

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

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

getChar

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

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

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

getShort

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

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

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

getInt

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

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

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

getLong

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

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

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

getFloat

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

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

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

getDouble

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

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

Параметры:
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.
https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/reflect/Array.html

Spec-Zone .ru
спецификации, руководства, описания, API