Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class Array extends Object
Array
class обеспечивает статические методы, чтобы динамически создать и получить доступ к массивам Java. Array
разрешения, расширяющие преобразования, чтобы произойти во время того, чтобы получать или операции присвоения, но бросков IllegalArgumentException
если сужающееся преобразование произошло бы.
Модификатор и Тип | Метод и Описание |
---|---|
static Object |
get(Object array, int index)
Возвращает значение индексированного компонента в указанном объекте массива.
|
static boolean |
getBoolean(Object array, int index)
Возвращает значение индексированного компонента в указанном объекте массива, как a
boolean . |
static byte |
getByte(Object array, int index)
Возвращает значение индексированного компонента в указанном объекте массива, как a
byte . |
static char |
getChar(Object array, int index)
Возвращает значение индексированного компонента в указанном объекте массива, как a
char . |
static double |
getDouble(Object array, int index)
Возвращает значение индексированного компонента в указанном объекте массива, как a
double . |
static float |
getFloat(Object array, int index)
Возвращает значение индексированного компонента в указанном объекте массива, как a
float . |
static int |
getInt(Object array, int index)
Возвращает значение индексированного компонента в указанном объекте массива, как
int . |
static int |
getLength(Object array)
Возвращает длину указанного объекта массива, как
int . |
static long |
getLong(Object array, int index)
Возвращает значение индексированного компонента в указанном объекте массива, как a
long . |
static short |
getShort(Object array, int index)
Возвращает значение индексированного компонента в указанном объекте массива, как a
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 значение. |
public static Object newInstance(Class<?> componentType, int length) throws NegativeArraySizeException
int[] x = {length}; Array.newInstance(componentType, x);
componentType
- Class
объект, представляющий компонентный тип нового массиваlength
- длина нового массиваNullPointerException
- если указанное componentType
параметр является нулемIllegalArgumentException
- если componentType является Void.TYPE
NegativeArraySizeException
- если указанное length
отрицательноpublic static Object newInstance(Class<?> componentType, int... dimensions) throws IllegalArgumentException, NegativeArraySizeException
componentType
представляет немассив class или интерфейс, новый массив имеет dimensions.length
размерности и componentType
как его компонентный тип. Если componentType
представляет массив class, число размерностей нового массива равно сумме dimensions.length
и число размерностей componentType
. В этом случае компонентный тип нового массива является компонентным типом componentType
. Число размерностей нового массива не должно превысить число размерностей массива, поддерживаемых реализацией (обычно 255).
componentType
- Class
объект, представляющий компонентный тип нового массиваdimensions
- массив int
представление размерностей нового массиваNullPointerException
- если указанное componentType
параметром является нульIllegalArgumentException
- если указанное dimensions
параметром является массив нулевой размерности, или если число требуемых размерностей превышает предел на числе размерностей массива, поддерживаемых реализацией (обычно 255), или если componentType Void.TYPE
.NegativeArraySizeException
- если любой из компонентов в указанном dimensions
параметр отрицателен.public static int getLength(Object array) throws IllegalArgumentException
int
.array
- массивIllegalArgumentException
- если объектным параметром не является массивpublic static Object get(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
array
- массивindex
- индексированиеNullPointerException
- Если указанный объект является нулемIllegalArgumentException
- Если указанный объект не является массивомArrayIndexOutOfBoundsException
- Если указанное index
параметр отрицателен, или если это больше чем или равно длине указанного массиваpublic static boolean getBoolean(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
boolean
.array
- массивindex
- индексированиеNullPointerException
- Если указанный объект является нулемIllegalArgumentException
- Если указанный объект не является массивом, или если индексированный элемент не может быть преобразован в тип возврата идентификационными данными или расширяющимся преобразованиемArrayIndexOutOfBoundsException
- Если указанное index
параметр отрицателен, или если это больше чем или равно длине указанного массиваget(java.lang.Object, int)
public static byte getByte(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
byte
.array
- массивindex
- индексированиеNullPointerException
- Если указанный объект является нулемIllegalArgumentException
- Если указанный объект не является массивом, или если индексированный элемент не может быть преобразован в тип возврата идентификационными данными или расширяющимся преобразованиемArrayIndexOutOfBoundsException
- Если указанное index
параметр отрицателен, или если это больше чем или равно длине указанного массиваget(java.lang.Object, int)
public static char getChar(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
char
.array
- массивindex
- индексированиеNullPointerException
- Если указанный объект является нулемIllegalArgumentException
- Если указанный объект не является массивом, или если индексированный элемент не может быть преобразован в тип возврата идентификационными данными или расширяющимся преобразованиемArrayIndexOutOfBoundsException
- Если указанное index
параметр отрицателен, или если это больше чем или равно длине указанного массиваget(java.lang.Object, int)
public static short getShort(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
short
.array
- массивindex
- индексированиеNullPointerException
- Если указанный объект является нулемIllegalArgumentException
- Если указанный объект не является массивом, или если индексированный элемент не может быть преобразован в тип возврата идентификационными данными или расширяющимся преобразованиемArrayIndexOutOfBoundsException
- Если указанное index
параметр отрицателен, или если это больше чем или равно длине указанного массиваget(java.lang.Object, int)
public static int getInt(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
int
.array
- массивindex
- индексированиеNullPointerException
- Если указанный объект является нулемIllegalArgumentException
- Если указанный объект не является массивом, или если индексированный элемент не может быть преобразован в тип возврата идентификационными данными или расширяющимся преобразованиемArrayIndexOutOfBoundsException
- Если указанное index
параметр отрицателен, или если это больше чем или равно длине указанного массиваget(java.lang.Object, int)
public static long getLong(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
long
.array
- массивindex
- индексированиеNullPointerException
- Если указанный объект является нулемIllegalArgumentException
- Если указанный объект не является массивом, или если индексированный элемент не может быть преобразован в тип возврата идентификационными данными или расширяющимся преобразованиемArrayIndexOutOfBoundsException
- Если указанное index
параметр отрицателен, или если это больше чем или равно длине указанного массиваget(java.lang.Object, int)
public static float getFloat(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
float
.array
- массивindex
- индексированиеNullPointerException
- Если указанный объект является нулемIllegalArgumentException
- Если указанный объект не является массивом, или если индексированный элемент не может быть преобразован в тип возврата идентификационными данными или расширяющимся преобразованиемArrayIndexOutOfBoundsException
- Если указанное index
параметр отрицателен, или если это больше чем или равно длине указанного массиваget(java.lang.Object, int)
public static double getDouble(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
double
.array
- массивindex
- индексированиеNullPointerException
- Если указанный объект является нулемIllegalArgumentException
- Если указанный объект не является массивом, или если индексированный элемент не может быть преобразован в тип возврата идентификационными данными или расширяющимся преобразованиемArrayIndexOutOfBoundsException
- Если указанное index
параметр отрицателен, или если это больше чем или равно длине указанного массиваget(java.lang.Object, int)
public static void set(Object array, int index, Object value) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
array
- массивindex
- индексирование в массивvalue
- новое значение индексированного компонентаNullPointerException
- Если указанным объектным параметром является нульIllegalArgumentException
- Если указанным объектным параметром не является массив, или если компонентный тип массива примитивен, и преобразование разворачивания перестало работатьArrayIndexOutOfBoundsException
- Если указанное index
параметр отрицателен, или если это больше чем или равно длине указанного массиваpublic static void setBoolean(Object array, int index, boolean z) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
boolean
значение.array
- массивindex
- индексирование в массивz
- новое значение индексированного компонентаNullPointerException
- Если указанным объектным параметром является нульIllegalArgumentException
- Если указанным объектным параметром не является массив, или если указанное значение не может быть преобразовано в компонентный тип базового массива идентификационными данными или примитивным расширяющимся преобразованиемArrayIndexOutOfBoundsException
- Если указанное index
параметр отрицателен, или если это больше чем или равно длине указанного массиваset(java.lang.Object, int, java.lang.Object)
public static void setByte(Object array, int index, byte b) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
byte
значение.array
- массивindex
- индексирование в массивb
- новое значение индексированного компонентаNullPointerException
- Если указанным объектным параметром является нульIllegalArgumentException
- Если указанным объектным параметром не является массив, или если указанное значение не может быть преобразовано в компонентный тип базового массива идентификационными данными или примитивным расширяющимся преобразованиемArrayIndexOutOfBoundsException
- Если указанное index
параметр отрицателен, или если это больше чем или равно длине указанного массиваset(java.lang.Object, int, java.lang.Object)
public static void setChar(Object array, int index, char c) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
char
значение.array
- массивindex
- индексирование в массивc
- новое значение индексированного компонентаNullPointerException
- Если указанным объектным параметром является нульIllegalArgumentException
- Если указанным объектным параметром не является массив, или если указанное значение не может быть преобразовано в компонентный тип базового массива идентификационными данными или примитивным расширяющимся преобразованиемArrayIndexOutOfBoundsException
- Если указанное index
параметр отрицателен, или если это больше чем или равно длине указанного массиваset(java.lang.Object, int, java.lang.Object)
public static void setShort(Object array, int index, short s) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
short
значение.array
- массивindex
- индексирование в массивs
- новое значение индексированного компонентаNullPointerException
- Если указанным объектным параметром является нульIllegalArgumentException
- Если указанным объектным параметром не является массив, или если указанное значение не может быть преобразовано в компонентный тип базового массива идентификационными данными или примитивным расширяющимся преобразованиемArrayIndexOutOfBoundsException
- Если указанное index
параметр отрицателен, или если это больше чем или равно длине указанного массиваset(java.lang.Object, int, java.lang.Object)
public static void setInt(Object array, int index, int i) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
int
значение.array
- массивindex
- индексирование в массивi
- новое значение индексированного компонентаNullPointerException
- Если указанным объектным параметром является нульIllegalArgumentException
- Если указанным объектным параметром не является массив, или если указанное значение не может быть преобразовано в компонентный тип базового массива идентификационными данными или примитивным расширяющимся преобразованиемArrayIndexOutOfBoundsException
- Если указанное index
параметр отрицателен, или если это больше чем или равно длине указанного массиваset(java.lang.Object, int, java.lang.Object)
public static void setLong(Object array, int index, long l) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
long
значение.array
- массивindex
- индексирование в массивl
- новое значение индексированного компонентаNullPointerException
- Если указанным объектным параметром является нульIllegalArgumentException
- Если указанным объектным параметром не является массив, или если указанное значение не может быть преобразовано в компонентный тип базового массива идентификационными данными или примитивным расширяющимся преобразованиемArrayIndexOutOfBoundsException
- Если указанное index
параметр отрицателен, или если это больше чем или равно длине указанного массиваset(java.lang.Object, int, java.lang.Object)
public static void setFloat(Object array, int index, float f) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
float
значение.array
- массивindex
- индексирование в массивf
- новое значение индексированного компонентаNullPointerException
- Если указанным объектным параметром является нульIllegalArgumentException
- Если указанным объектным параметром не является массив, или если указанное значение не может быть преобразовано в компонентный тип базового массива идентификационными данными или примитивным расширяющимся преобразованиемArrayIndexOutOfBoundsException
- Если указанное index
параметр отрицателен, или если это больше чем или равно длине указанного массиваset(java.lang.Object, int, java.lang.Object)
public static void setDouble(Object array, int index, double d) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
double
значение.array
- массивindex
- индексирование в массивd
- новое значение индексированного компонентаNullPointerException
- Если указанным объектным параметром является нульIllegalArgumentException
- Если указанным объектным параметром не является массив, или если указанное значение не может быть преобразовано в компонентный тип базового массива идентификационными данными или примитивным расширяющимся преобразованиемArrayIndexOutOfBoundsException
- Если указанное index
параметр отрицателен, или если это больше чем или равно длине указанного массиваset(java.lang.Object, int, java.lang.Object)
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92