sample/java.lang.reflect.Array.txt

   1 *java.lang.reflect.Array* *Array* The Array class provides static methods to dyn
   2
   3 public final class Array
   4   extends    |java.lang.Object|
   5
   6 |java.lang.reflect.Array_Description|
   7 |java.lang.reflect.Array_Fields|
   8 |java.lang.reflect.Array_Constructors|
   9 |java.lang.reflect.Array_Methods|
  10
  11 ================================================================================
  12
  13 *java.lang.reflect.Array_Methods*
  14 |java.lang.reflect.Array.get(Object,int)|Returns the value of the indexed compo
  15 |java.lang.reflect.Array.getBoolean(Object,int)|Returns the value of the indexe
  16 |java.lang.reflect.Array.getByte(Object,int)|Returns the value of the indexed c
  17 |java.lang.reflect.Array.getChar(Object,int)|Returns the value of the indexed c
  18 |java.lang.reflect.Array.getDouble(Object,int)|Returns the value of the indexed
  19 |java.lang.reflect.Array.getFloat(Object,int)|Returns the value of the indexed
  20 |java.lang.reflect.Array.getInt(Object,int)|Returns the value of the indexed co
  21 |java.lang.reflect.Array.getLength(Object)|Returns the length of the specified
  22 |java.lang.reflect.Array.getLong(Object,int)|Returns the value of the indexed c
  23 |java.lang.reflect.Array.getShort(Object,int)|Returns the value of the indexed
  24 |java.lang.reflect.Array.newInstance(Class,int)|Creates a new array with the sp
  25 |java.lang.reflect.Array.newInstance(Class,int[])|Creates a new array  with the
  26 |java.lang.reflect.Array.set(Object,int,Object)|Sets the value of the indexed c
  27 |java.lang.reflect.Array.setBoolean(Object,int,boolean)|Sets the value of the i
  28 |java.lang.reflect.Array.setByte(Object,int,byte)|Sets the value of the indexed
  29 |java.lang.reflect.Array.setChar(Object,int,char)|Sets the value of the indexed
  30 |java.lang.reflect.Array.setDouble(Object,int,double)|Sets the value of the ind
  31 |java.lang.reflect.Array.setFloat(Object,int,float)|Sets the value of the index
  32 |java.lang.reflect.Array.setInt(Object,int,int)|Sets the value of the indexed c
  33 |java.lang.reflect.Array.setLong(Object,int,long)|Sets the value of the indexed
  34 |java.lang.reflect.Array.setShort(Object,int,short)|Sets the value of the index
  35
  36 *java.lang.reflect.Array_Description*
  37
  38 The Array class provides static methods to dynamically create and access Java
  39 arrays.
  40
  41 Array permits widening conversions to occur during a get or set operation, but
  42 throws an IllegalArgumentException if a narrowing conversion would occur.
  43
  44
  45 *java.lang.reflect.Array.get(Object,int)*
  46
  47 public static native |java.lang.Object| get(
  48   java.lang.Object array,
  49   int index)
  50   throws |java.lang.ArrayIndexOutOfBoundsException|
  51          |java.lang.IllegalArgumentException|
  52
  53 Returns the value of the indexed component in the specified array object. The
  54 value is automatically wrapped in an object if it has a primitive type.
  55
  56     array - the array
  57     index - the index
  58
  59     Returns: the (possibly wrapped) value of the indexed component in the specified array
  60 *java.lang.reflect.Array.getBoolean(Object,int)*
  61
  62 public static native boolean getBoolean(
  63   java.lang.Object array,
  64   int index)
  65   throws |java.lang.ArrayIndexOutOfBoundsException|
  66          |java.lang.IllegalArgumentException|
  67
  68 Returns the value of the indexed component in the specified array object, as a
  69 boolean.
  70
  71     array - the array
  72     index - the index
  73
  74     Returns: the value of the indexed component in the specified array
  75 *java.lang.reflect.Array.getByte(Object,int)*
  76
  77 public static native byte getByte(
  78   java.lang.Object array,
  79   int index)
  80   throws |java.lang.ArrayIndexOutOfBoundsException|
  81          |java.lang.IllegalArgumentException|
  82
  83 Returns the value of the indexed component in the specified array object, as a
  84 byte.
  85
  86     array - the array
  87     index - the index
  88
  89     Returns: the value of the indexed component in the specified array
  90 *java.lang.reflect.Array.getChar(Object,int)*
  91
  92 public static native char getChar(
  93   java.lang.Object array,
  94   int index)
  95   throws |java.lang.ArrayIndexOutOfBoundsException|
  96          |java.lang.IllegalArgumentException|
  97
  98 Returns the value of the indexed component in the specified array object, as a
  99 char.
 100
 101     array - the array
 102     index - the index
 103
 104     Returns: the value of the indexed component in the specified array
 105 *java.lang.reflect.Array.getDouble(Object,int)*
 106
 107 public static native double getDouble(
 108   java.lang.Object array,
 109   int index)
 110   throws |java.lang.ArrayIndexOutOfBoundsException|
 111          |java.lang.IllegalArgumentException|
 112
 113 Returns the value of the indexed component in the specified array object, as a
 114 double.
 115
 116     array - the array
 117     index - the index
 118
 119     Returns: the value of the indexed component in the specified array
 120 *java.lang.reflect.Array.getFloat(Object,int)*
 121
 122 public static native float getFloat(
 123   java.lang.Object array,
 124   int index)
 125   throws |java.lang.ArrayIndexOutOfBoundsException|
 126          |java.lang.IllegalArgumentException|
 127
 128 Returns the value of the indexed component in the specified array object, as a
 129 float.
 130
 131     array - the array
 132     index - the index
 133
 134     Returns: the value of the indexed component in the specified array
 135 *java.lang.reflect.Array.getInt(Object,int)*
 136
 137 public static native int getInt(
 138   java.lang.Object array,
 139   int index)
 140   throws |java.lang.ArrayIndexOutOfBoundsException|
 141          |java.lang.IllegalArgumentException|
 142
 143 Returns the value of the indexed component in the specified array object, as an
 144 int.
 145
 146     array - the array
 147     index - the index
 148
 149     Returns: the value of the indexed component in the specified array
 150 *java.lang.reflect.Array.getLength(Object)*
 151
 152 public static native int getLength(java.lang.Object array)
 153   throws |java.lang.IllegalArgumentException|
 154
 155 Returns the length of the specified array object, as an int.
 156
 157     array - the array
 158
 159     Returns: the length of the array
 160 *java.lang.reflect.Array.getLong(Object,int)*
 161
 162 public static native long getLong(
 163   java.lang.Object array,
 164   int index)
 165   throws |java.lang.ArrayIndexOutOfBoundsException|
 166          |java.lang.IllegalArgumentException|
 167
 168 Returns the value of the indexed component in the specified array object, as a
 169 long.
 170
 171     array - the array
 172     index - the index
 173
 174     Returns: the value of the indexed component in the specified array
 175 *java.lang.reflect.Array.getShort(Object,int)*
 176
 177 public static native short getShort(
 178   java.lang.Object array,
 179   int index)
 180   throws |java.lang.ArrayIndexOutOfBoundsException|
 181          |java.lang.IllegalArgumentException|
 182
 183 Returns the value of the indexed component in the specified array object, as a
 184 short.
 185
 186     array - the array
 187     index - the index
 188
 189     Returns: the value of the indexed component in the specified array
 190 *java.lang.reflect.Array.newInstance(Class,int)*
 191
 192 public static |java.lang.Object| newInstance(
 193   java.lang.Class componentType,
 194   int length)
 195   throws |java.lang.NegativeArraySizeException|
 196
 197 Creates a new array with the specified component type and length. Invoking this
 198 method is equivalent to creating an array as follows:
 199
 200
 201
 202 int[] x = {length}; Array.newInstance(componentType, x);
 203
 204
 205
 206     componentType - the Class object representing the component type of the new array
 207     length - the length of the new array
 208
 209     Returns: the new array
 210 *java.lang.reflect.Array.newInstance(Class,int[])*
 211
 212 public static |java.lang.Object| newInstance(
 213   java.lang.Class componentType,
 214   int[] dimensions)
 215   throws |java.lang.IllegalArgumentException|
 216          |java.lang.NegativeArraySizeException|
 217
 218 Creates a new array with the specified component type and dimensions. If
 219 componentType represents a non-array class or interface, the new array has
 220 dimensions.length dimensions and componentType as its component type. If
 221 componentType represents an array class, the number of dimensions of the new
 222 array is equal to the sum of dimensions.length and the number of dimensions of
 223 componentType. In this case, the component type of the new array is the
 224 component type of componentType.
 225
 226 The number of dimensions of the new array must not exceed the number of array
 227 dimensions supported by the implementation (typically 255).
 228
 229     componentType - the Class object representing the component type of the new array
 230     dimensions - an array of int types representing the dimensions of the new array
 231
 232     Returns: the new array
 233 *java.lang.reflect.Array.set(Object,int,Object)*
 234
 235 public static native void set(
 236   java.lang.Object array,
 237   int index,
 238   java.lang.Object value)
 239   throws |java.lang.ArrayIndexOutOfBoundsException|
 240          |java.lang.IllegalArgumentException|
 241
 242 Sets the value of the indexed component of the specified array object to the
 243 specified new value. The new value is first automatically unwrapped if the
 244 array has a primitive component type.
 245
 246     array - the array
 247     index - the index into the array
 248     value - the new value of the indexed component
 249
 250 *java.lang.reflect.Array.setBoolean(Object,int,boolean)*
 251
 252 public static native void setBoolean(
 253   java.lang.Object array,
 254   int index,
 255   boolean z)
 256   throws |java.lang.ArrayIndexOutOfBoundsException|
 257          |java.lang.IllegalArgumentException|
 258
 259 Sets the value of the indexed component of the specified array object to the
 260 specified boolean value.
 261
 262     array - the array
 263     index - the index into the array
 264     z - the new value of the indexed component
 265
 266 *java.lang.reflect.Array.setByte(Object,int,byte)*
 267
 268 public static native void setByte(
 269   java.lang.Object array,
 270   int index,
 271   byte b)
 272   throws |java.lang.ArrayIndexOutOfBoundsException|
 273          |java.lang.IllegalArgumentException|
 274
 275 Sets the value of the indexed component of the specified array object to the
 276 specified byte value.
 277
 278     array - the array
 279     index - the index into the array
 280     b - the new value of the indexed component
 281
 282 *java.lang.reflect.Array.setChar(Object,int,char)*
 283
 284 public static native void setChar(
 285   java.lang.Object array,
 286   int index,
 287   char c)
 288   throws |java.lang.ArrayIndexOutOfBoundsException|
 289          |java.lang.IllegalArgumentException|
 290
 291 Sets the value of the indexed component of the specified array object to the
 292 specified char value.
 293
 294     array - the array
 295     index - the index into the array
 296     c - the new value of the indexed component
 297
 298 *java.lang.reflect.Array.setDouble(Object,int,double)*
 299
 300 public static native void setDouble(
 301   java.lang.Object array,
 302   int index,
 303   double d)
 304   throws |java.lang.ArrayIndexOutOfBoundsException|
 305          |java.lang.IllegalArgumentException|
 306
 307 Sets the value of the indexed component of the specified array object to the
 308 specified double value.
 309
 310     array - the array
 311     index - the index into the array
 312     d - the new value of the indexed component
 313
 314 *java.lang.reflect.Array.setFloat(Object,int,float)*
 315
 316 public static native void setFloat(
 317   java.lang.Object array,
 318   int index,
 319   float f)
 320   throws |java.lang.ArrayIndexOutOfBoundsException|
 321          |java.lang.IllegalArgumentException|
 322
 323 Sets the value of the indexed component of the specified array object to the
 324 specified float value.
 325
 326     array - the array
 327     index - the index into the array
 328     f - the new value of the indexed component
 329
 330 *java.lang.reflect.Array.setInt(Object,int,int)*
 331
 332 public static native void setInt(
 333   java.lang.Object array,
 334   int index,
 335   int i)
 336   throws |java.lang.ArrayIndexOutOfBoundsException|
 337          |java.lang.IllegalArgumentException|
 338
 339 Sets the value of the indexed component of the specified array object to the
 340 specified int value.
 341
 342     array - the array
 343     index - the index into the array
 344     i - the new value of the indexed component
 345
 346 *java.lang.reflect.Array.setLong(Object,int,long)*
 347
 348 public static native void setLong(
 349   java.lang.Object array,
 350   int index,
 351   long l)
 352   throws |java.lang.ArrayIndexOutOfBoundsException|
 353          |java.lang.IllegalArgumentException|
 354
 355 Sets the value of the indexed component of the specified array object to the
 356 specified long value.
 357
 358     array - the array
 359     index - the index into the array
 360     l - the new value of the indexed component
 361
 362 *java.lang.reflect.Array.setShort(Object,int,short)*
 363
 364 public static native void setShort(
 365   java.lang.Object array,
 366   int index,
 367   short s)
 368   throws |java.lang.ArrayIndexOutOfBoundsException|
 369          |java.lang.IllegalArgumentException|
 370
 371 Sets the value of the indexed component of the specified array object to the
 372 specified short value.
 373
 374     array - the array
 375     index - the index into the array
 376     s - the new value of the indexed component
 377
 378