Package org.jmol.util

Class ArrayUtil

java.lang.Object

org.jmol.util.ArrayUtil

public final class ArrayUtil
extends java.lang.Object

Constructor Summary

Constructors

Constructor	Description
ArrayUtil()

Method Summary

Modifier and Type	Method	Description
static boolean[]	arrayCopyBool(boolean[] array, int newLength)
static byte[]	arrayCopyByte(byte[] array, int newLength)
static float[]	arrayCopyF(float[] array, int newLength)
static int[]	arrayCopyI(int[] array, int newLength)
static int[][]	arrayCopyII(int[][] array, int newLength)
static java.lang.Object	arrayCopyObject(java.lang.Object array, int newLength)	note -- cannot copy if array is null!
static Point3f[]	arrayCopyPt(Point3f[] array, int newLength)
static int[]	arrayCopyRangeI(int[] array, int i0, int n)	a specialized method that allows copying from a starting point either to the end or to the middle (color schemes, especially)
static int[]	arrayCopyRangeRevI(int[] array, int i0, int n)
static java.lang.String[]	arrayCopyS(java.lang.String[] array, int newLength)
static short[]	arrayCopyShort(short[] array, int newLength)
static <T> java.util.List<T>[]	createArrayOfArrayList(int size)	Helper method for creating a List<T>[]without warnings.
static <K,V> java.util.Map<K,V>[]	createArrayOfHashtable(int size)	Helper method for creating a Map<K, V>[] without warnings.
static java.lang.Object	deleteElements(java.lang.Object array, int firstElement, int nElements)
static java.lang.Object	doubleLength(java.lang.Object array)	Very important that this not be used with Int32Array or Float32Array, because it is not initialized to all zeros in MSIE 9.
static boolean[]	doubleLengthBool(boolean[] array)
static byte[]	doubleLengthByte(byte[] array)
static float[]	doubleLengthF(float[] array)
static int[]	doubleLengthI(int[] array)
static java.lang.String[]	doubleLengthS(java.lang.String[] array)
static short[]	doubleLengthShort(short[] array)
static java.lang.String	dumpArray(java.lang.String msg, float[][] A, int x1, int x2, int y1, int y2)
static java.lang.String	dumpIntArray(int[] A, int n)
static java.lang.Object	ensureLength(java.lang.Object array, int minimumLength)	Very important that this not be used with Int32Array or Float32Array, because it is not initialized to all zeros in MSIE 9.
static float[]	ensureLengthA(float[] array, int minimumLength)
static byte[]	ensureLengthByte(byte[] array, int minimumLength)
static int[]	ensureLengthI(int[] array, int minimumLength)
static java.lang.String[]	ensureLengthS(java.lang.String[] array, int minimumLength)
static short[]	ensureLengthShort(short[] array, int minimumLength)
static byte[][]	newByte2(int n)
static float[][]	newFloat2(int n)
static float[][][]	newFloat3(int nx, int ny)
static int[][]	newInt2(int n)
static int[][][][]	newInt4(int n)
static short[][]	newShort2(int n)
static java.lang.String	sortedItem(java.util.List<java.lang.String> v, int n)
static void	swap(java.lang.Object[] o, int i, int j)
static void	swapInt(int[] array, int indexA, int indexB)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ArrayUtil

public ArrayUtil()

Method Detail

ensureLength

public static java.lang.Object ensureLength(java.lang.Object array,
                                            int minimumLength)

Very important that this not be used with Int32Array or Float32Array, because it is not initialized to all zeros in MSIE 9.

Parameters:

array -

minimumLength -

Returns:

array

ensureLengthS

public static java.lang.String[] ensureLengthS(java.lang.String[] array,
                                               int minimumLength)

ensureLengthA

public static float[] ensureLengthA(float[] array,
                                    int minimumLength)

ensureLengthI

public static int[] ensureLengthI(int[] array,
                                  int minimumLength)

ensureLengthShort

public static short[] ensureLengthShort(short[] array,
                                        int minimumLength)

ensureLengthByte

public static byte[] ensureLengthByte(byte[] array,
                                      int minimumLength)

doubleLength

public static java.lang.Object doubleLength(java.lang.Object array)

Very important that this not be used with Int32Array or Float32Array, because it is not initialized to all zeros in MSIE 9.

Parameters:

array -

Returns:

array

doubleLengthS

public static java.lang.String[] doubleLengthS(java.lang.String[] array)

doubleLengthF

public static float[] doubleLengthF(float[] array)

doubleLengthI

public static int[] doubleLengthI(int[] array)

doubleLengthShort

public static short[] doubleLengthShort(short[] array)

doubleLengthByte

public static byte[] doubleLengthByte(byte[] array)

doubleLengthBool

public static boolean[] doubleLengthBool(boolean[] array)

deleteElements

public static java.lang.Object deleteElements(java.lang.Object array,
                                              int firstElement,
                                              int nElements)

arrayCopyObject

public static java.lang.Object arrayCopyObject(java.lang.Object array,
                                               int newLength)

note -- cannot copy if array is null!

Parameters:

array -

newLength -

Returns:

array

arrayCopyS

public static java.lang.String[] arrayCopyS(java.lang.String[] array,
                                            int newLength)

arrayCopyII

public static int[][] arrayCopyII(int[][] array,
                                  int newLength)

arrayCopyPt

public static Point3f[] arrayCopyPt(Point3f[] array,
                                    int newLength)

arrayCopyF

public static float[] arrayCopyF(float[] array,
                                 int newLength)

arrayCopyI

public static int[] arrayCopyI(int[] array,
                               int newLength)

arrayCopyRangeI

public static int[] arrayCopyRangeI(int[] array,
                                    int i0,
                                    int n)

a specialized method that allows copying from a starting point either to the end or to the middle (color schemes, especially)

Parameters:

array -

i0 -

n -

Returns:

array or null

arrayCopyRangeRevI

public static int[] arrayCopyRangeRevI(int[] array,
                                       int i0,
                                       int n)

arrayCopyShort

public static short[] arrayCopyShort(short[] array,
                                     int newLength)

arrayCopyByte

public static byte[] arrayCopyByte(byte[] array,
                                   int newLength)

arrayCopyBool

public static boolean[] arrayCopyBool(boolean[] array,
                                      int newLength)

swapInt

public static void swapInt(int[] array,
                           int indexA,
                           int indexB)

dumpArray

public static java.lang.String dumpArray(java.lang.String msg,
                                         float[][] A,
                                         int x1,
                                         int x2,
                                         int y1,
                                         int y2)

dumpIntArray

public static java.lang.String dumpIntArray(int[] A,
                                            int n)

sortedItem

public static java.lang.String sortedItem(java.util.List<java.lang.String> v,
                                          int n)

createArrayOfArrayList

public static <T> java.util.List<T>[] createArrayOfArrayList(int size)

Helper method for creating a List<T>[]without warnings.

Type Parameters:

T - Type of objects in the list.

Parameters:

size - Array size.

Returns:

Array of List<T>

createArrayOfHashtable

public static <K,V> java.util.Map<K,V>[] createArrayOfHashtable(int size)

Helper method for creating a Map<K, V>[] without warnings.

Type Parameters:

K - Type of object for the keys in the map.

V - Type of object for the values in the map.

Parameters:

size - Array size.

Returns:

Array of Map

swap

public static void swap(java.lang.Object[] o,
                        int i,
                        int j)

newFloat2

public static float[][] newFloat2(int n)

newInt2

public static int[][] newInt2(int n)

newFloat3

public static float[][][] newFloat3(int nx,
                                    int ny)

newInt4

public static int[][][][] newInt4(int n)

newShort2

public static short[][] newShort2(int n)

newByte2

public static byte[][] newByte2(int n)