diff options
Diffstat (limited to 'libjava/classpath/java/lang/reflect/Array.java')
| -rw-r--r-- | libjava/classpath/java/lang/reflect/Array.java | 655 |
1 files changed, 0 insertions, 655 deletions
diff --git a/libjava/classpath/java/lang/reflect/Array.java b/libjava/classpath/java/lang/reflect/Array.java deleted file mode 100644 index a31e48e..0000000 --- a/libjava/classpath/java/lang/reflect/Array.java +++ /dev/null @@ -1,655 +0,0 @@ -/* java.lang.reflect.Array - manipulate arrays by reflection - Copyright (C) 1998, 1999, 2001, 2003, 2005 Free Software Foundation, Inc. - -This file is part of GNU Classpath. - -GNU Classpath is free software; you can redistribute it and/or modify -it under the terms of the GNU General Public License as published by -the Free Software Foundation; either version 2, or (at your option) -any later version. - -GNU Classpath is distributed in the hope that it will be useful, but -WITHOUT ANY WARRANTY; without even the implied warranty of -MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -General Public License for more details. - -You should have received a copy of the GNU General Public License -along with GNU Classpath; see the file COPYING. If not, write to the -Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA -02110-1301 USA. - -Linking this library statically or dynamically with other modules is -making a combined work based on this library. Thus, the terms and -conditions of the GNU General Public License cover the whole -combination. - -As a special exception, the copyright holders of this library give you -permission to link this library with independent modules to produce an -executable, regardless of the license terms of these independent -modules, and to copy and distribute the resulting executable under -terms of your choice, provided that you also meet, for each linked -independent module, the terms and conditions of the license of that -module. An independent module is a module which is not derived from -or based on this library. If you modify this library, you may extend -this exception to your version of the library, but you are not -obligated to do so. If you do not wish to do so, delete this -exception statement from your version. */ - - -package java.lang.reflect; - -/** - * Array holds static helper functions that allow you to create and - * manipulate arrays by reflection. Operations know how to perform widening - * conversions, but throw {@link IllegalArgumentException} if you attempt - * a narrowing conversion. Also, when accessing primitive arrays, this - * class performs object wrapping and unwrapping as necessary.<p> - * - * <B>Note:</B> This class returns and accepts types as Classes, even - * primitive types; there are Class types defined that represent each - * different primitive type. They are <code>java.lang.Boolean.TYPE, - * java.lang.Byte.TYPE,</code>, also available as <code>boolean.class, - * byte.class</code>, etc. These are not to be confused with the - * classes <code>java.lang.Boolean, java.lang.Byte</code>, etc., which are - * real classes. Note also that the shorthand <code>Object[].class</code> - * is a convenient way to get array Classes.<p> - * - * <B>Performance note:</B> This class performs best when it does not have - * to convert primitive types. The further along the chain it has to convert, - * the worse performance will be. You're best off using the array as whatever - * type it already is, and then converting the result. You will do even - * worse if you do this and use the generic set() function. - * - * @author John Keiser - * @author Eric Blake (ebb9@email.byu.edu) - * @author Per Bothner (bothner@cygnus.com) - * @see java.lang.Boolean#TYPE - * @see java.lang.Byte#TYPE - * @see java.lang.Short#TYPE - * @see java.lang.Character#TYPE - * @see java.lang.Integer#TYPE - * @see java.lang.Long#TYPE - * @see java.lang.Float#TYPE - * @see java.lang.Double#TYPE - * @since 1.1 - * @status updated to 1.4 - */ -public final class Array -{ - - /** - * This class is uninstantiable. - */ - private Array() - { - } - - /** - * Creates a new single-dimensioned array. - * @param componentType the type of the array to create - * @param length the length of the array to create - * @return the created array, cast to an Object - * @throws NullPointerException if <code>componentType</code> is null - * @throws IllegalArgumentException if <code>componentType</code> is - * <code>Void.TYPE</code> - * @throws NegativeArraySizeException when length is less than 0 - * @throws OutOfMemoryError if memory allocation fails - */ - public static Object newInstance(Class<?> componentType, int length) - { - if (! componentType.isPrimitive()) - return VMArray.createObjectArray(componentType, length); - if (componentType == boolean.class) - return new boolean[length]; - if (componentType == byte.class) - return new byte[length]; - if (componentType == char.class) - return new char[length]; - if (componentType == short.class) - return new short[length]; - if (componentType == int.class) - return new int[length]; - if (componentType == long.class) - return new long[length]; - if (componentType == float.class) - return new float[length]; - if (componentType == double.class) - return new double[length]; - // assert componentType == void.class - throw new IllegalArgumentException(); - } - - /** - * Creates a new multi-dimensioned array. The new array has the same - * component type as the argument class, and the number of dimensions - * in the new array is the sum of the dimensions of the argument class - * and the length of the argument dimensions. Virtual Machine limitations - * forbid too many dimensions (usually 255 is the maximum); but even - * 50 dimensions of 2 elements in each dimension would exceed your memory - * long beforehand! - * - * @param componentType the type of the array to create. - * @param dimensions the dimensions of the array to create. Each element - * in <code>dimensions</code> makes another dimension of the new - * array. Thus, <code>Array.newInstance(java.lang.Boolean, - * new int[]{1,2,3})</code> is the same as - * <code>new java.lang.Boolean[1][2][3]</code> - * @return the created array, cast to an Object - * @throws NullPointerException if componentType or dimension is null - * @throws IllegalArgumentException if the the size of - * <code>dimensions</code> is 0 or exceeds the maximum number of - * array dimensions in the VM; or if componentType is Void.TYPE - * @throws NegativeArraySizeException when any of the dimensions is less - * than 0 - * @throws OutOfMemoryError if memory allocation fails - */ - public static Object newInstance(Class<?> componentType, int[] dimensions) - { - if (dimensions.length <= 0) - throw new IllegalArgumentException ("Empty dimensions array."); - return createMultiArray(componentType, dimensions, 0); - } - - /** - * Gets the array length. - * @param array the array - * @return the length of the array - * @throws IllegalArgumentException if <code>array</code> is not an array - * @throws NullPointerException if <code>array</code> is null - */ - public static int getLength(Object array) - { - if (array instanceof Object[]) - return ((Object[]) array).length; - if (array instanceof boolean[]) - return ((boolean[]) array).length; - if (array instanceof byte[]) - return ((byte[]) array). length; - if (array instanceof char[]) - return ((char[]) array).length; - if (array instanceof short[]) - return ((short[]) array).length; - if (array instanceof int[]) - return ((int[]) array).length; - if (array instanceof long[]) - return ((long[]) array).length; - if (array instanceof float[]) - return ((float[]) array).length; - if (array instanceof double[]) - return ((double[]) array).length; - if (array == null) - throw new NullPointerException(); - throw new IllegalArgumentException(); - } - - /** - * Gets an element of an array. Primitive elements will be wrapped in - * the corresponding class type. - * - * @param array the array to access - * @param index the array index to access - * @return the element at <code>array[index]</code> - * @throws IllegalArgumentException if <code>array</code> is not an array - * @throws NullPointerException if <code>array</code> is null - * @throws ArrayIndexOutOfBoundsException if <code>index</code> is out of - * bounds - * @see #getBoolean(Object, int) - * @see #getByte(Object, int) - * @see #getChar(Object, int) - * @see #getShort(Object, int) - * @see #getInt(Object, int) - * @see #getLong(Object, int) - * @see #getFloat(Object, int) - * @see #getDouble(Object, int) - */ - public static Object get(Object array, int index) - { - if (array instanceof Object[]) - return ((Object[]) array)[index]; - if (array instanceof boolean[]) - return ((boolean[]) array)[index] ? Boolean.TRUE : Boolean.FALSE; - if (array instanceof byte[]) - return Byte.valueOf(((byte[]) array)[index]); - if (array instanceof char[]) - return Character.valueOf(((char[]) array)[index]); - if (array instanceof short[]) - return Short.valueOf(((short[]) array)[index]); - if (array instanceof int[]) - return Integer.valueOf(((int[]) array)[index]); - if (array instanceof long[]) - return Long.valueOf(((long[]) array)[index]); - if (array instanceof float[]) - return Float.valueOf(((float[]) array)[index]); - if (array instanceof double[]) - return Double.valueOf(((double[]) array)[index]); - if (array == null) - throw new NullPointerException(); - throw new IllegalArgumentException(); - } - - /** - * Gets an element of a boolean array. - * - * @param array the array to access - * @param index the array index to access - * @return the boolean element at <code>array[index]</code> - * @throws IllegalArgumentException if <code>array</code> is not a boolean - * array - * @throws NullPointerException if <code>array</code> is null - * @throws ArrayIndexOutOfBoundsException if <code>index</code> is out of - * bounds - * @see #get(Object, int) - */ - public static boolean getBoolean(Object array, int index) - { - if (array instanceof boolean[]) - return ((boolean[]) array)[index]; - if (array == null) - throw new NullPointerException(); - throw new IllegalArgumentException(); - } - - /** - * Gets an element of a byte array. - * - * @param array the array to access - * @param index the array index to access - * @return the byte element at <code>array[index]</code> - * @throws IllegalArgumentException if <code>array</code> is not a byte - * array - * @throws NullPointerException if <code>array</code> is null - * @throws ArrayIndexOutOfBoundsException if <code>index</code> is out of - * bounds - * @see #get(Object, int) - */ - public static byte getByte(Object array, int index) - { - if (array instanceof byte[]) - return ((byte[]) array)[index]; - if (array == null) - throw new NullPointerException(); - throw new IllegalArgumentException(); - } - - /** - * Gets an element of a char array. - * - * @param array the array to access - * @param index the array index to access - * @return the char element at <code>array[index]</code> - * @throws IllegalArgumentException if <code>array</code> is not a char - * array - * @throws NullPointerException if <code>array</code> is null - * @throws ArrayIndexOutOfBoundsException if <code>index</code> is out of - * bounds - * @see #get(Object, int) - */ - public static char getChar(Object array, int index) - { - if (array instanceof char[]) - return ((char[]) array)[index]; - if (array == null) - throw new NullPointerException(); - throw new IllegalArgumentException(); - } - - /** - * Gets an element of a short array. - * - * @param array the array to access - * @param index the array index to access - * @return the short element at <code>array[index]</code> - * @throws IllegalArgumentException if <code>array</code> is not a byte - * or char array - * @throws NullPointerException if <code>array</code> is null - * @throws ArrayIndexOutOfBoundsException if <code>index</code> is out of - * bounds - * @see #get(Object, int) - */ - public static short getShort(Object array, int index) - { - if (array instanceof short[]) - return ((short[]) array)[index]; - return getByte(array, index); - } - - /** - * Gets an element of an int array. - * - * @param array the array to access - * @param index the array index to access - * @return the int element at <code>array[index]</code> - * @throws IllegalArgumentException if <code>array</code> is not a byte, - * char, short, or int array - * @throws NullPointerException if <code>array</code> is null - * @throws ArrayIndexOutOfBoundsException if <code>index</code> is out of - * bounds - * @see #get(Object, int) - */ - public static int getInt(Object array, int index) - { - if (array instanceof int[]) - return ((int[]) array)[index]; - if (array instanceof char[]) - return ((char[]) array)[index]; - return getShort(array, index); - } - - /** - * Gets an element of a long array. - * - * @param array the array to access - * @param index the array index to access - * @return the long element at <code>array[index]</code> - * @throws IllegalArgumentException if <code>array</code> is not a byte, - * char, short, int, or long array - * @throws NullPointerException if <code>array</code> is null - * @throws ArrayIndexOutOfBoundsException if <code>index</code> is out of - * bounds - * @see #get(Object, int) - */ - public static long getLong(Object array, int index) - { - if (array instanceof long[]) - return ((long[]) array)[index]; - return getInt(array, index); - } - - /** - * Gets an element of a float array. - * - * @param array the array to access - * @param index the array index to access - * @return the float element at <code>array[index]</code> - * @throws IllegalArgumentException if <code>array</code> is not a byte, - * char, short, int, long, or float array - * @throws NullPointerException if <code>array</code> is null - * @throws ArrayIndexOutOfBoundsException if <code>index</code> is out of - * bounds - * @see #get(Object, int) - */ - public static float getFloat(Object array, int index) - { - if (array instanceof float[]) - return ((float[]) array)[index]; - return getLong(array, index); - } - - /** - * Gets an element of a double array. - * - * @param array the array to access - * @param index the array index to access - * @return the double element at <code>array[index]</code> - * @throws IllegalArgumentException if <code>array</code> is not a byte, - * char, short, int, long, float, or double array - * @throws NullPointerException if <code>array</code> is null - * @throws ArrayIndexOutOfBoundsException if <code>index</code> is out of - * bounds - * @see #get(Object, int) - */ - public static double getDouble(Object array, int index) - { - if (array instanceof double[]) - return ((double[]) array)[index]; - return getFloat(array, index); - } - - /** - * Sets an element of an array. If the array is primitive, then the new - * value is unwrapped and widened. - * - * @param array the array to set a value of - * @param index the array index to set the value to - * @param value the value to set - * @throws IllegalArgumentException if <code>array</code> is not an array, - * or the array is primitive and unwrapping value fails, or the - * value is not assignable to the array component type - * @throws NullPointerException if array is null, or if array is primitive - * and value is null - * @throws ArrayIndexOutOfBoundsException if <code>index</code> is out of - * bounds - * @see #setBoolean(Object, int, boolean) - * @see #setByte(Object, int, byte) - * @see #setChar(Object, int, char) - * @see #setShort(Object, int, short) - * @see #setInt(Object, int, int) - * @see #setLong(Object, int, long) - * @see #setFloat(Object, int, float) - * @see #setDouble(Object, int, double) - */ - public static void set(Object array, int index, Object value) - { - if (array instanceof Object[]) - { - // Too bad the API won't let us throw the easier ArrayStoreException! - if (value != null - && ! array.getClass().getComponentType().isInstance(value)) - throw new IllegalArgumentException(); - ((Object[]) array)[index] = value; - } - else if (value instanceof Byte) - setByte(array, index, ((Byte) value).byteValue()); - else if (value instanceof Short) - setShort(array, index, ((Short) value).shortValue()); - else if (value instanceof Integer) - setInt(array, index, ((Integer) value).intValue()); - else if (value instanceof Long) - setLong(array, index, ((Long) value).longValue()); - else if (value instanceof Float) - setFloat(array, index, ((Float) value).floatValue()); - else if (value instanceof Double) - setDouble(array, index, ((Double) value).doubleValue()); - else if (value instanceof Character) - setChar(array, index, ((Character) value).charValue()); - else if (value instanceof Boolean) - setBoolean(array, index, ((Boolean) value).booleanValue()); - else if (array == null) - throw new NullPointerException(); - else - throw new IllegalArgumentException(); - } - - /** - * Sets an element of a boolean array. - * - * @param array the array to set a value of - * @param index the array index to set the value to - * @param value the value to set - * @throws IllegalArgumentException if <code>array</code> is not a boolean - * array - * @throws NullPointerException if <code>array</code> is null - * @throws ArrayIndexOutOfBoundsException if <code>index</code> is out of - * bounds - * @see #set(Object, int, Object) - */ - public static void setBoolean(Object array, int index, boolean value) - { - if (array instanceof boolean[]) - ((boolean[]) array)[index] = value; - else if (array == null) - throw new NullPointerException(); - else - throw new IllegalArgumentException(); - } - - /** - * Sets an element of a byte array. - * - * @param array the array to set a value of - * @param index the array index to set the value to - * @param value the value to set - * @throws IllegalArgumentException if <code>array</code> is not a byte, - * short, int, long, float, or double array - * @throws NullPointerException if <code>array</code> is null - * @throws ArrayIndexOutOfBoundsException if <code>index</code> is out of - * bounds - * @see #set(Object, int, Object) - */ - public static void setByte(Object array, int index, byte value) - { - if (array instanceof byte[]) - ((byte[]) array)[index] = value; - else - setShort(array, index, value); - } - - /** - * Sets an element of a char array. - * - * @param array the array to set a value of - * @param index the array index to set the value to - * @param value the value to set - * @throws IllegalArgumentException if <code>array</code> is not a char, - * int, long, float, or double array - * @throws NullPointerException if <code>array</code> is null - * @throws ArrayIndexOutOfBoundsException if <code>index</code> is out of - * bounds - * @see #set(Object, int, Object) - */ - public static void setChar(Object array, int index, char value) - { - if (array instanceof char[]) - ((char[]) array)[index] = value; - else - setInt(array, index, value); - } - - /** - * Sets an element of a short array. - * - * @param array the array to set a value of - * @param index the array index to set the value to - * @param value the value to set - * @throws IllegalArgumentException if <code>array</code> is not a short, - * int, long, float, or double array - * @throws NullPointerException if <code>array</code> is null - * @throws ArrayIndexOutOfBoundsException if <code>index</code> is out of - * bounds - * @see #set(Object, int, Object) - */ - public static void setShort(Object array, int index, short value) - { - if (array instanceof short[]) - ((short[]) array)[index] = value; - else - setInt(array, index, value); - } - - /** - * Sets an element of an int array. - * - * @param array the array to set a value of - * @param index the array index to set the value to - * @param value the value to set - * @throws IllegalArgumentException if <code>array</code> is not an int, - * long, float, or double array - * @throws NullPointerException if <code>array</code> is null - * @throws ArrayIndexOutOfBoundsException if <code>index</code> is out of - * bounds - * @see #set(Object, int, Object) - */ - public static void setInt(Object array, int index, int value) - { - if (array instanceof int[]) - ((int[]) array)[index] = value; - else - setLong(array, index, value); - } - - /** - * Sets an element of a long array. - * - * @param array the array to set a value of - * @param index the array index to set the value to - * @param value the value to set - * @throws IllegalArgumentException if <code>array</code> is not a long, - * float, or double array - * @throws NullPointerException if <code>array</code> is null - * @throws ArrayIndexOutOfBoundsException if <code>index</code> is out of - * bounds - * @see #set(Object, int, Object) - */ - public static void setLong(Object array, int index, long value) - { - if (array instanceof long[]) - ((long[]) array)[index] = value; - else - setFloat(array, index, value); - } - - /** - * Sets an element of a float array. - * - * @param array the array to set a value of - * @param index the array index to set the value to - * @param value the value to set - * @throws IllegalArgumentException if <code>array</code> is not a float - * or double array - * @throws NullPointerException if <code>array</code> is null - * @throws ArrayIndexOutOfBoundsException if <code>index</code> is out of - * bounds - * @see #set(Object, int, Object) - */ - public static void setFloat(Object array, int index, float value) - { - if (array instanceof float[]) - ((float[]) array)[index] = value; - else - setDouble(array, index, value); - } - - /** - * Sets an element of a double array. - * - * @param array the array to set a value of - * @param index the array index to set the value to - * @param value the value to set - * @throws IllegalArgumentException if <code>array</code> is not a double - * array - * @throws NullPointerException if <code>array</code> is null - * @throws ArrayIndexOutOfBoundsException if <code>index</code> is out of - * bounds - * @see #set(Object, int, Object) - */ - public static void setDouble(Object array, int index, double value) - { - if (array instanceof double[]) - ((double[]) array)[index] = value; - else if (array == null) - throw new NullPointerException(); - else - throw new IllegalArgumentException(); - } - - /** - * Dynamically and recursively create a multi-dimensioned array of objects. - * - * @param type guaranteed to be a valid object type - * @param dimensions the dimensions of the array - * @param index index of the current dimension to build - * @return the new multi-dimensioned array - * @throws NegativeArraySizeException if any entry of dimensions is negative - * @throws OutOfMemoryError if memory allocation fails - */ - // This would be faster if implemented natively, using the multianewarray - // bytecode instead of this recursive call - private static Object createMultiArray(Class type, int[] dimensions, - int index) - { - if (index == dimensions.length - 1) - return newInstance(type, dimensions[index]); - - Object toAdd = createMultiArray(type, dimensions, index + 1); - Class thisType = toAdd.getClass(); - Object[] retval - = (Object[]) VMArray.createObjectArray(thisType, dimensions[index]); - if (dimensions[index] > 0) - retval[0] = toAdd; - int i = dimensions[index]; - while (--i > 0) - retval[i] = createMultiArray(type, dimensions, index + 1); - return retval; - } - -} |