- 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)
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-java/lang/reflect/Array.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.