RetroSearch Browse

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/lang/reflect/Array.html below:

Array (Java SE 17 & JDK 17)

public final class Array extends Object

The

Array

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 an IllegalArgumentException if a narrowing conversion would occur.

Since:: 1.1

Method Summary
Returns the value of the indexed component in the specified array object.

static boolean

Returns the value of the indexed component in the specified array object, as a boolean.

static byte

Returns the value of the indexed component in the specified array object, as a byte.

static char

Returns the value of the indexed component in the specified array object, as a char.

static double

Returns the value of the indexed component in the specified array object, as a double.

static float

Returns the value of the indexed component in the specified array object, as a float.

static int

Returns the value of the indexed component in the specified array object, as an int.

static int

Returns the length of the specified array object, as an int.

static long

Returns the value of the indexed component in the specified array object, as a long.

static short

Returns the value of the indexed component in the specified array object, as a short.

Creates a new array with the specified component type and length.

Creates a new array with the specified component type and dimensions.

static void

Sets the value of the indexed component of the specified array object to the specified new value.

static void

Sets the value of the indexed component of the specified array object to the specified boolean value.

static void

Sets the value of the indexed component of the specified array object to the specified byte value.

static void

Sets the value of the indexed component of the specified array object to the specified char value.

static void

Sets the value of the indexed component of the specified array object to the specified double value.

static void

Sets the value of the indexed component of the specified array object to the specified float value.

static void

Sets the value of the indexed component of the specified array object to the specified int value.

static void

Sets the value of the indexed component of the specified array object to the specified long value.

static void

Sets the value of the indexed component of the specified array object to the specified short value.
Methods declared in class java.lang.Objectclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details
- newInstance
  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);
 
```
  The number of dimensions of the new array must not exceed 255.
  
  Parameters:
  
  componentType - the Class object representing the component type of the new array
  
  length - the length of the new array
  
  Returns:
  
  the new array
  
  Throws:
  
  NullPointerException - if the specified componentType parameter is null
  
  IllegalArgumentException - if componentType is Void.TYPE or if the number of dimensions of the requested array instance exceed 255.
  
  NegativeArraySizeException - if the specified length is negative
- newInstance
  Creates a new array with the specified component type and dimensions. If
  componentType
  represents a non-array class or interface, the new array has
  dimensions.length
  dimensions and
  componentType
  as its component type. If
  componentType
  represents an array class, the number of dimensions of the new array is equal to the sum of
  dimensions.length
  and the number of dimensions of
  componentType
  . In this case, the component type of the new array is the component type of
  componentType
  .
  
  The number of dimensions of the new array must not exceed 255.
  
  Parameters:
  
  componentType - the Class object representing the component type of the new array
  
  dimensions - an array of int representing the dimensions of the new array
  
  Returns:
  
  the new array
  
  Throws:
  
  NullPointerException - if the specified componentType argument is null
  
  IllegalArgumentException - if the specified dimensions argument is a zero-dimensional array, if componentType is Void.TYPE, or if the number of dimensions of the requested array instance exceed 255.
  
  NegativeArraySizeException - if any of the components in the specified dimensions argument is negative.
- getLength
  Returns the length of the specified array object, as an int.
  
  Parameters:
  
  array - the array
  
  Returns:
  
  the length of the array
  
  Throws:
  
  IllegalArgumentException - if the object argument is not an array
- get
  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 array
  
  index - the index
  
  Returns:
  
  the (possibly wrapped) value of the indexed component in the specified array
  
  Throws:
  
  NullPointerException - If the specified object is null
  
  IllegalArgumentException - If the specified object is not an array
  
  ArrayIndexOutOfBoundsException - If the specified index argument is negative, or if it is greater than or equal to the length of the specified array
- getBoolean
  Returns the value of the indexed component in the specified array object, as a boolean.
  Parameters:
  
  array - the array
  
  index - the index
  
  Returns:
  
  the value of the indexed component in the specified array
  
  Throws:
  
  NullPointerException - If the specified object is null
  
  IllegalArgumentException - 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 conversion
  
  ArrayIndexOutOfBoundsException - If the specified index 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
  Returns the value of the indexed component in the specified array object, as a byte.
  Parameters:
  
  array - the array
  
  index - the index
  
  Returns:
  
  the value of the indexed component in the specified array
  
  Throws:
  
  NullPointerException - If the specified object is null
  
  IllegalArgumentException - 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 conversion
  
  ArrayIndexOutOfBoundsException - If the specified index 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
  Returns the value of the indexed component in the specified array object, as a char.
  Parameters:
  
  array - the array
  
  index - the index
  
  Returns:
  
  the value of the indexed component in the specified array
  
  Throws:
  
  NullPointerException - If the specified object is null
  
  IllegalArgumentException - 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 conversion
  
  ArrayIndexOutOfBoundsException - If the specified index 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
  Returns the value of the indexed component in the specified array object, as a short.
  Parameters:
  
  array - the array
  
  index - the index
  
  Returns:
  
  the value of the indexed component in the specified array
  
  Throws:
  
  NullPointerException - If the specified object is null
  
  IllegalArgumentException - 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 conversion
  
  ArrayIndexOutOfBoundsException - If the specified index 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
  Returns the value of the indexed component in the specified array object, as an int.
  Parameters:
  
  array - the array
  
  index - the index
  
  Returns:
  
  the value of the indexed component in the specified array
  
  Throws:
  
  NullPointerException - If the specified object is null
  
  IllegalArgumentException - 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 conversion
  
  ArrayIndexOutOfBoundsException - If the specified index 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
  Returns the value of the indexed component in the specified array object, as a long.
  Parameters:
  
  array - the array
  
  index - the index
  
  Returns:
  
  the value of the indexed component in the specified array
  
  Throws:
  
  NullPointerException - If the specified object is null
  
  IllegalArgumentException - 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 conversion
  
  ArrayIndexOutOfBoundsException - If the specified index 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
  Returns the value of the indexed component in the specified array object, as a float.
  Parameters:
  
  array - the array
  
  index - the index
  
  Returns:
  
  the value of the indexed component in the specified array
  
  Throws:
  
  NullPointerException - If the specified object is null
  
  IllegalArgumentException - 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 conversion
  
  ArrayIndexOutOfBoundsException - If the specified index 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
  Returns the value of the indexed component in the specified array object, as a double.
  Parameters:
  
  array - the array
  
  index - the index
  
  Returns:
  
  the value of the indexed component in the specified array
  
  Throws:
  
  NullPointerException - If the specified object is null
  
  IllegalArgumentException - 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 conversion
  
  ArrayIndexOutOfBoundsException - If the specified index 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
  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 array
  
  index - the index into the array
  
  value - the new value of the indexed component
  
  Throws:
  
  NullPointerException - If the specified object argument is null
  
  IllegalArgumentException - If the specified object argument is not an array, or if the array component type is primitive and an unwrapping conversion fails
  
  ArrayIndexOutOfBoundsException - If the specified index argument is negative, or if it is greater than or equal to the length of the specified array
- setBoolean
  Sets the value of the indexed component of the specified array object to the specified boolean value.
  Parameters:
  
  array - the array
  
  index - the index into the array
  
  z - the new value of the indexed component
  
  Throws:
  
  NullPointerException - If the specified object argument is null
  
  IllegalArgumentException - 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 conversion
  
  ArrayIndexOutOfBoundsException - If the specified index 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
  Sets the value of the indexed component of the specified array object to the specified byte value.
  Parameters:
  
  array - the array
  
  index - the index into the array
  
  b - the new value of the indexed component
  
  Throws:
  
  NullPointerException - If the specified object argument is null
  
  IllegalArgumentException - 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 conversion
  
  ArrayIndexOutOfBoundsException - If the specified index 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
  Sets the value of the indexed component of the specified array object to the specified char value.
  Parameters:
  
  array - the array
  
  index - the index into the array
  
  c - the new value of the indexed component
  
  Throws:
  
  NullPointerException - If the specified object argument is null
  
  IllegalArgumentException - 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 conversion
  
  ArrayIndexOutOfBoundsException - If the specified index 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
  Sets the value of the indexed component of the specified array object to the specified short value.
  Parameters:
  
  array - the array
  
  index - the index into the array
  
  s - the new value of the indexed component
  
  Throws:
  
  NullPointerException - If the specified object argument is null
  
  IllegalArgumentException - 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 conversion
  
  ArrayIndexOutOfBoundsException - If the specified index 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
  Sets the value of the indexed component of the specified array object to the specified int value.
  Parameters:
  
  array - the array
  
  index - the index into the array
  
  i - the new value of the indexed component
  
  Throws:
  
  NullPointerException - If the specified object argument is null
  
  IllegalArgumentException - 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 conversion
  
  ArrayIndexOutOfBoundsException - If the specified index 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
  Sets the value of the indexed component of the specified array object to the specified long value.
  Parameters:
  
  array - the array
  
  index - the index into the array
  
  l - the new value of the indexed component
  
  Throws:
  
  NullPointerException - If the specified object argument is null
  
  IllegalArgumentException - 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 conversion
  
  ArrayIndexOutOfBoundsException - If the specified index 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
  Sets the value of the indexed component of the specified array object to the specified float value.
  Parameters:
  
  array - the array
  
  index - the index into the array
  
  f - the new value of the indexed component
  
  Throws:
  
  NullPointerException - If the specified object argument is null
  
  IllegalArgumentException - 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 conversion
  
  ArrayIndexOutOfBoundsException - If the specified index 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
  Sets the value of the indexed component of the specified array object to the specified double value.
  Parameters:
  
  array - the array
  
  index - the index into the array
  
  d - the new value of the indexed component
  
  Throws:
  
  NullPointerException - If the specified object argument is null
  
  IllegalArgumentException - 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 conversion
  
  ArrayIndexOutOfBoundsException - If the specified index 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)

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4