- java.lang.Object
-
- java.lang.reflect.Array
-
public final class Array extends Object
TheArray
class provides static methods to dynamically create and access Java arrays.Array
permits widening conversions to occur during a get or set operation, but throws anIllegalArgumentException
if a narrowing conversion would occur.
-
-
Method Summary
Methods Modifier and Type Method and Description static Object
get(Object array, int index)
Returns the value of the indexed component in the specified array object.static boolean
getBoolean(Object array, int index)
Returns the value of the indexed component in the specified array object, as aboolean
.static byte
getByte(Object array, int index)
Returns the value of the indexed component in the specified array object, as abyte
.static char
getChar(Object array, int index)
Returns the value of the indexed component in the specified array object, as achar
.static double
getDouble(Object array, int index)
Returns the value of the indexed component in the specified array object, as adouble
.static float
getFloat(Object array, int index)
Returns the value of the indexed component in the specified array object, as afloat
.static int
getInt(Object array, int index)
Returns the value of the indexed component in the specified array object, as anint
.static int
getLength(Object array)
Returns the length of the specified array object, as anint
.static long
getLong(Object array, int index)
Returns the value of the indexed component in the specified array object, as along
.static short
getShort(Object array, int index)
Returns the value of the indexed component in the specified array object, as ashort
.static Object
newInstance(Class<?> componentType, int... dimensions)
Creates a new array with the specified component type and dimensions.static Object
newInstance(Class<?> componentType, int length)
Creates a new array with the specified component type and length.static void
set(Object array, int index, Object value)
Sets the value of the indexed component of the specified array object to the specified new value.static void
setBoolean(Object array, int index, boolean z)
Sets the value of the indexed component of the specified array object to the specifiedboolean
value.static void
setByte(Object array, int index, byte b)
Sets the value of the indexed component of the specified array object to the specifiedbyte
value.static void
setChar(Object array, int index, char c)
Sets the value of the indexed component of the specified array object to the specifiedchar
value.static void
setDouble(Object array, int index, double d)
Sets the value of the indexed component of the specified array object to the specifieddouble
value.static void
setFloat(Object array, int index, float f)
Sets the value of the indexed component of the specified array object to the specifiedfloat
value.static void
setInt(Object array, int index, int i)
Sets the value of the indexed component of the specified array object to the specifiedint
value.static void
setLong(Object array, int index, long l)
Sets the value of the indexed component of the specified array object to the specifiedlong
value.static void
setShort(Object array, int index, short s)
Sets the value of the indexed component of the specified array object to the specifiedshort
value.
-
-
-
Method Detail
-
newInstance
public static Object newInstance(Class<?> componentType, int length) throws NegativeArraySizeException
Creates a new array with the specified component type and length. Invoking this method is equivalent to creating an array as follows:int[] x = {length}; Array.newInstance(componentType, x);
- Parameters:
componentType
- theClass
object representing the component type of the new arraylength
- the length of the new array- Returns:
- the new array
- Throws:
NullPointerException
- if the specifiedcomponentType
parameter is nullIllegalArgumentException
- if componentType isVoid.TYPE
NegativeArraySizeException
- if the specifiedlength
is negative
-
newInstance
public static Object newInstance(Class<?> componentType, int... dimensions) throws IllegalArgumentException, NegativeArraySizeException
Creates a new array with the specified component type and dimensions. IfcomponentType
represents a non-array class or interface, the new array hasdimensions.length
dimensions andcomponentType
as its component type. IfcomponentType
represents an array class, the number of dimensions of the new array is equal to the sum ofdimensions.length
and the number of dimensions ofcomponentType
. In this case, the component type of the new array is the component type ofcomponentType
.The number of dimensions of the new array must not exceed the number of array dimensions supported by the implementation (typically 255).
- Parameters:
componentType
- theClass
object representing the component type of the new arraydimensions
- an array ofint
representing the dimensions of the new array- Returns:
- the new array
- Throws:
NullPointerException
- if the specifiedcomponentType
argument is nullIllegalArgumentException
- if the specifieddimensions
argument is a zero-dimensional array, or if the number of requested dimensions exceeds the limit on the number of array dimensions supported by the implementation (typically 255), or if componentType isVoid.TYPE
.NegativeArraySizeException
- if any of the components in the specifieddimensions
argument is negative.
-
getLength
public static int getLength(Object array) throws IllegalArgumentException
Returns the length of the specified array object, as anint
.- Parameters:
array
- the array- Returns:
- the length of the array
- Throws:
IllegalArgumentException
- if the object argument is not an array
-
get
public static Object get(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
Returns the value of the indexed component in the specified array object. The value is automatically wrapped in an object if it has a primitive type.- Parameters:
array
- the arrayindex
- the index- Returns:
- the (possibly wrapped) value of the indexed component in the specified array
- Throws:
NullPointerException
- If the specified object is nullIllegalArgumentException
- If the specified object is not an arrayArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array
-
getBoolean
public static boolean getBoolean(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
Returns the value of the indexed component in the specified array object, as aboolean
.- Parameters:
array
- the arrayindex
- the index- Returns:
- the value of the indexed component in the specified array
- Throws:
NullPointerException
- If the specified object is nullIllegalArgumentException
- If the specified object is not an array, or if the indexed element cannot be converted to the return type by an identity or widening conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
get(java.lang.Object, int)
-
getByte
public static byte getByte(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
Returns the value of the indexed component in the specified array object, as abyte
.- Parameters:
array
- the arrayindex
- the index- Returns:
- the value of the indexed component in the specified array
- Throws:
NullPointerException
- If the specified object is nullIllegalArgumentException
- If the specified object is not an array, or if the indexed element cannot be converted to the return type by an identity or widening conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
get(java.lang.Object, int)
-
getChar
public static char getChar(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
Returns the value of the indexed component in the specified array object, as achar
.- Parameters:
array
- the arrayindex
- the index- Returns:
- the value of the indexed component in the specified array
- Throws:
NullPointerException
- If the specified object is nullIllegalArgumentException
- If the specified object is not an array, or if the indexed element cannot be converted to the return type by an identity or widening conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
get(java.lang.Object, int)
-
getShort
public static short getShort(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
Returns the value of the indexed component in the specified array object, as ashort
.- Parameters:
array
- the arrayindex
- the index- Returns:
- the value of the indexed component in the specified array
- Throws:
NullPointerException
- If the specified object is nullIllegalArgumentException
- If the specified object is not an array, or if the indexed element cannot be converted to the return type by an identity or widening conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
get(java.lang.Object, int)
-
getInt
public static int getInt(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
Returns the value of the indexed component in the specified array object, as anint
.- Parameters:
array
- the arrayindex
- the index- Returns:
- the value of the indexed component in the specified array
- Throws:
NullPointerException
- If the specified object is nullIllegalArgumentException
- If the specified object is not an array, or if the indexed element cannot be converted to the return type by an identity or widening conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
get(java.lang.Object, int)
-
getLong
public static long getLong(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
Returns the value of the indexed component in the specified array object, as along
.- Parameters:
array
- the arrayindex
- the index- Returns:
- the value of the indexed component in the specified array
- Throws:
NullPointerException
- If the specified object is nullIllegalArgumentException
- If the specified object is not an array, or if the indexed element cannot be converted to the return type by an identity or widening conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
get(java.lang.Object, int)
-
getFloat
public static float getFloat(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
Returns the value of the indexed component in the specified array object, as afloat
.- Parameters:
array
- the arrayindex
- the index- Returns:
- the value of the indexed component in the specified array
- Throws:
NullPointerException
- If the specified object is nullIllegalArgumentException
- If the specified object is not an array, or if the indexed element cannot be converted to the return type by an identity or widening conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
get(java.lang.Object, int)
-
getDouble
public static double getDouble(Object array, int index) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
Returns the value of the indexed component in the specified array object, as adouble
.- Parameters:
array
- the arrayindex
- the index- Returns:
- the value of the indexed component in the specified array
- Throws:
NullPointerException
- If the specified object is nullIllegalArgumentException
- If the specified object is not an array, or if the indexed element cannot be converted to the return type by an identity or widening conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
get(java.lang.Object, int)
-
set
public static void set(Object array, int index, Object value) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
Sets the value of the indexed component of the specified array object to the specified new value. The new value is first automatically unwrapped if the array has a primitive component type.- Parameters:
array
- the arrayindex
- the index into the arrayvalue
- the new value of the indexed component- Throws:
NullPointerException
- If the specified object argument is nullIllegalArgumentException
- If the specified object argument is not an array, or if the array component type is primitive and an unwrapping conversion failsArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array
-
setBoolean
public static void setBoolean(Object array, int index, boolean z) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
Sets the value of the indexed component of the specified array object to the specifiedboolean
value.- Parameters:
array
- the arrayindex
- the index into the arrayz
- the new value of the indexed component- Throws:
NullPointerException
- If the specified object argument is nullIllegalArgumentException
- If the specified object argument is not an array, or if the specified value cannot be converted to the underlying array's component type by an identity or a primitive widening conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
set(java.lang.Object, int, java.lang.Object)
-
setByte
public static void setByte(Object array, int index, byte b) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
Sets the value of the indexed component of the specified array object to the specifiedbyte
value.- Parameters:
array
- the arrayindex
- the index into the arrayb
- the new value of the indexed component- Throws:
NullPointerException
- If the specified object argument is nullIllegalArgumentException
- If the specified object argument is not an array, or if the specified value cannot be converted to the underlying array's component type by an identity or a primitive widening conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
set(java.lang.Object, int, java.lang.Object)
-
setChar
public static void setChar(Object array, int index, char c) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
Sets the value of the indexed component of the specified array object to the specifiedchar
value.- Parameters:
array
- the arrayindex
- the index into the arrayc
- the new value of the indexed component- Throws:
NullPointerException
- If the specified object argument is nullIllegalArgumentException
- If the specified object argument is not an array, or if the specified value cannot be converted to the underlying array's component type by an identity or a primitive widening conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
set(java.lang.Object, int, java.lang.Object)
-
setShort
public static void setShort(Object array, int index, short s) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
Sets the value of the indexed component of the specified array object to the specifiedshort
value.- Parameters:
array
- the arrayindex
- the index into the arrays
- the new value of the indexed component- Throws:
NullPointerException
- If the specified object argument is nullIllegalArgumentException
- If the specified object argument is not an array, or if the specified value cannot be converted to the underlying array's component type by an identity or a primitive widening conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
set(java.lang.Object, int, java.lang.Object)
-
setInt
public static void setInt(Object array, int index, int i) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
Sets the value of the indexed component of the specified array object to the specifiedint
value.- Parameters:
array
- the arrayindex
- the index into the arrayi
- the new value of the indexed component- Throws:
NullPointerException
- If the specified object argument is nullIllegalArgumentException
- If the specified object argument is not an array, or if the specified value cannot be converted to the underlying array's component type by an identity or a primitive widening conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
set(java.lang.Object, int, java.lang.Object)
-
setLong
public static void setLong(Object array, int index, long l) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
Sets the value of the indexed component of the specified array object to the specifiedlong
value.- Parameters:
array
- the arrayindex
- the index into the arrayl
- the new value of the indexed component- Throws:
NullPointerException
- If the specified object argument is nullIllegalArgumentException
- If the specified object argument is not an array, or if the specified value cannot be converted to the underlying array's component type by an identity or a primitive widening conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
set(java.lang.Object, int, java.lang.Object)
-
setFloat
public static void setFloat(Object array, int index, float f) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
Sets the value of the indexed component of the specified array object to the specifiedfloat
value.- Parameters:
array
- the arrayindex
- the index into the arrayf
- the new value of the indexed component- Throws:
NullPointerException
- If the specified object argument is nullIllegalArgumentException
- If the specified object argument is not an array, or if the specified value cannot be converted to the underlying array's component type by an identity or a primitive widening conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
set(java.lang.Object, int, java.lang.Object)
-
setDouble
public static void setDouble(Object array, int index, double d) throws IllegalArgumentException, ArrayIndexOutOfBoundsException
Sets the value of the indexed component of the specified array object to the specifieddouble
value.- Parameters:
array
- the arrayindex
- the index into the arrayd
- the new value of the indexed component- Throws:
NullPointerException
- If the specified object argument is nullIllegalArgumentException
- If the specified object argument is not an array, or if the specified value cannot be converted to the underlying array's component type by an identity or a primitive widening conversionArrayIndexOutOfBoundsException
- If the specifiedindex
argument is negative, or if it is greater than or equal to the length of the specified array- See Also:
set(java.lang.Object, int, java.lang.Object)
-
-
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 11/06/2005, zuletzt geändert 04/03/2020
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-rf-java/lang/reflect/array.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.