Package cern.colt

Class Arrays

java.lang.Object
cern.colt.Arrays
public class Arrays
extends Object
Array manipulations; complements java.util.Arrays.
Version:
1.0, 03-Jul-99
Author:
wolfgang.hoschek@cern.ch
See Also:
Arrays, Sorting

  • Constructor Summary

    Constructors 
    Modifier Constructor Description
    protected Arrays()
    Makes this class non instantiable, but still let's others inherit from it.

  • Method Summary

    Modifier and Type Method Description
    static boolean[] ensureCapacity​(boolean[] array, int minCapacity)
    Ensures that a given array can hold up to minCapacity elements.
    static byte[] ensureCapacity​(byte[] array, int minCapacity)
    Ensures that a given array can hold up to minCapacity elements.
    static char[] ensureCapacity​(char[] array, int minCapacity)
    Ensures that a given array can hold up to minCapacity elements.
    static double[] ensureCapacity​(double[] array, int minCapacity)
    Ensures that a given array can hold up to minCapacity elements.
    static float[] ensureCapacity​(float[] array, int minCapacity)
    Ensures that a given array can hold up to minCapacity elements.
    static int[] ensureCapacity​(int[] array, int minCapacity)
    Ensures that a given array can hold up to minCapacity elements.
    static long[] ensureCapacity​(long[] array, int minCapacity)
    Ensures that a given array can hold up to minCapacity elements.
    static short[] ensureCapacity​(short[] array, int minCapacity)
    Ensures that a given array can hold up to minCapacity elements.
    static Object[] ensureCapacity​(Object[] array, int minCapacity)
    Ensures that a given array can hold up to minCapacity elements.
    static String toString​(boolean[] array)
    Returns a string representation of the specified array.
    static String toString​(byte[] array)
    Returns a string representation of the specified array.
    static String toString​(char[] array)
    Returns a string representation of the specified array.
    static String toString​(double[] array)
    Returns a string representation of the specified array.
    static String toString​(float[] array)
    Returns a string representation of the specified array.
    static String toString​(int[] array)
    Returns a string representation of the specified array.
    static String toString​(long[] array)
    Returns a string representation of the specified array.
    static String toString​(short[] array)
    Returns a string representation of the specified array.
    static String toString​(Object[] array)
    Returns a string representation of the specified array.
    static boolean[] trimToCapacity​(boolean[] array, int maxCapacity)
    Ensures that the specified array cannot hold more than maxCapacity elements.
    static byte[] trimToCapacity​(byte[] array, int maxCapacity)
    Ensures that the specified array cannot hold more than maxCapacity elements.
    static char[] trimToCapacity​(char[] array, int maxCapacity)
    Ensures that the specified array cannot hold more than maxCapacity elements.
    static double[] trimToCapacity​(double[] array, int maxCapacity)
    Ensures that the specified array cannot hold more than maxCapacity elements.
    static float[] trimToCapacity​(float[] array, int maxCapacity)
    Ensures that the specified array cannot hold more than maxCapacity elements.
    static int[] trimToCapacity​(int[] array, int maxCapacity)
    Ensures that the specified array cannot hold more than maxCapacity elements.
    static long[] trimToCapacity​(long[] array, int maxCapacity)
    Ensures that the specified array cannot hold more than maxCapacity elements.
    static short[] trimToCapacity​(short[] array, int maxCapacity)
    Ensures that the specified array cannot hold more than maxCapacity elements.
    static Object[] trimToCapacity​(Object[] array, int maxCapacity)
    Ensures that the specified array cannot hold more than maxCapacity elements.

    Methods inherited from class java.lang.Object

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

  • Constructor Details

    • Arrays

      protected Arrays()
      Makes this class non instantiable, but still let's others inherit from it.

  • Method Details

    • ensureCapacity

      public static byte[] ensureCapacity​(byte[] array, int minCapacity)
      Ensures that a given array can hold up to minCapacity elements. Returns the identical array if it can hold at least the number of elements specified. Otherwise, returns a new array with increased capacity containing the same elements, ensuring that it can hold at least the number of elements specified by the minimum capacity argument.
      Parameters:
      minCapacity - the desired minimum capacity.

    • ensureCapacity

      public static char[] ensureCapacity​(char[] array, int minCapacity)
      Ensures that a given array can hold up to minCapacity elements. Returns the identical array if it can hold at least the number of elements specified. Otherwise, returns a new array with increased capacity containing the same elements, ensuring that it can hold at least the number of elements specified by the minimum capacity argument.
      Parameters:
      minCapacity - the desired minimum capacity.

    • ensureCapacity

      public static double[] ensureCapacity​(double[] array, int minCapacity)
      Ensures that a given array can hold up to minCapacity elements. Returns the identical array if it can hold at least the number of elements specified. Otherwise, returns a new array with increased capacity containing the same elements, ensuring that it can hold at least the number of elements specified by the minimum capacity argument.
      Parameters:
      minCapacity - the desired minimum capacity.

    • ensureCapacity

      public static float[] ensureCapacity​(float[] array, int minCapacity)
      Ensures that a given array can hold up to minCapacity elements. Returns the identical array if it can hold at least the number of elements specified. Otherwise, returns a new array with increased capacity containing the same elements, ensuring that it can hold at least the number of elements specified by the minimum capacity argument.
      Parameters:
      minCapacity - the desired minimum capacity.

    • ensureCapacity

      public static int[] ensureCapacity​(int[] array, int minCapacity)
      Ensures that a given array can hold up to minCapacity elements. Returns the identical array if it can hold at least the number of elements specified. Otherwise, returns a new array with increased capacity containing the same elements, ensuring that it can hold at least the number of elements specified by the minimum capacity argument.
      Parameters:
      minCapacity - the desired minimum capacity.

    • ensureCapacity

      public static long[] ensureCapacity​(long[] array, int minCapacity)
      Ensures that a given array can hold up to minCapacity elements. Returns the identical array if it can hold at least the number of elements specified. Otherwise, returns a new array with increased capacity containing the same elements, ensuring that it can hold at least the number of elements specified by the minimum capacity argument.
      Parameters:
      minCapacity - the desired minimum capacity.

    • ensureCapacity

      public static Object[] ensureCapacity​(Object[] array, int minCapacity)
      Ensures that a given array can hold up to minCapacity elements. Returns the identical array if it can hold at least the number of elements specified. Otherwise, returns a new array with increased capacity containing the same elements, ensuring that it can hold at least the number of elements specified by the minimum capacity argument.
      Parameters:
      minCapacity - the desired minimum capacity.

    • ensureCapacity

      public static short[] ensureCapacity​(short[] array, int minCapacity)
      Ensures that a given array can hold up to minCapacity elements. Returns the identical array if it can hold at least the number of elements specified. Otherwise, returns a new array with increased capacity containing the same elements, ensuring that it can hold at least the number of elements specified by the minimum capacity argument.
      Parameters:
      minCapacity - the desired minimum capacity.

    • ensureCapacity

      public static boolean[] ensureCapacity​(boolean[] array, int minCapacity)
      Ensures that a given array can hold up to minCapacity elements. Returns the identical array if it can hold at least the number of elements specified. Otherwise, returns a new array with increased capacity containing the same elements, ensuring that it can hold at least the number of elements specified by the minimum capacity argument.
      Parameters:
      minCapacity - the desired minimum capacity.

    • toString

      public static String toString​(byte[] array)
      Returns a string representation of the specified array. The string representation consists of a list of the arrays's elements, enclosed in square brackets ("[]"). Adjacent elements are separated by the characters ", " (comma and space).
      Returns:
      a string representation of the specified array.

    • toString

      public static String toString​(char[] array)
      Returns a string representation of the specified array. The string representation consists of a list of the arrays's elements, enclosed in square brackets ("[]"). Adjacent elements are separated by the characters ", " (comma and space).
      Returns:
      a string representation of the specified array.

    • toString

      public static String toString​(double[] array)
      Returns a string representation of the specified array. The string representation consists of a list of the arrays's elements, enclosed in square brackets ("[]"). Adjacent elements are separated by the characters ", " (comma and space).
      Returns:
      a string representation of the specified array.

    • toString

      public static String toString​(float[] array)
      Returns a string representation of the specified array. The string representation consists of a list of the arrays's elements, enclosed in square brackets ("[]"). Adjacent elements are separated by the characters ", " (comma and space).
      Returns:
      a string representation of the specified array.

    • toString

      public static String toString​(int[] array)
      Returns a string representation of the specified array. The string representation consists of a list of the arrays's elements, enclosed in square brackets ("[]"). Adjacent elements are separated by the characters ", " (comma and space).
      Returns:
      a string representation of the specified array.

    • toString

      public static String toString​(long[] array)
      Returns a string representation of the specified array. The string representation consists of a list of the arrays's elements, enclosed in square brackets ("[]"). Adjacent elements are separated by the characters ", " (comma and space).
      Returns:
      a string representation of the specified array.

    • toString

      public static String toString​(Object[] array)
      Returns a string representation of the specified array. The string representation consists of a list of the arrays's elements, enclosed in square brackets ("[]"). Adjacent elements are separated by the characters ", " (comma and space).
      Returns:
      a string representation of the specified array.

    • toString

      public static String toString​(short[] array)
      Returns a string representation of the specified array. The string representation consists of a list of the arrays's elements, enclosed in square brackets ("[]"). Adjacent elements are separated by the characters ", " (comma and space).
      Returns:
      a string representation of the specified array.

    • toString

      public static String toString​(boolean[] array)
      Returns a string representation of the specified array. The string representation consists of a list of the arrays's elements, enclosed in square brackets ("[]"). Adjacent elements are separated by the characters ", " (comma and space).
      Returns:
      a string representation of the specified array.

    • trimToCapacity

      public static byte[] trimToCapacity​(byte[] array, int maxCapacity)
      Ensures that the specified array cannot hold more than maxCapacity elements. An application can use this operation to minimize array storage.

      Returns the identical array if array.length <= maxCapacity. Otherwise, returns a new array with a length of maxCapacity containing the first maxCapacity elements of array.

      Parameters:
      maxCapacity - the desired maximum capacity.

    • trimToCapacity

      public static char[] trimToCapacity​(char[] array, int maxCapacity)
      Ensures that the specified array cannot hold more than maxCapacity elements. An application can use this operation to minimize array storage.

      Returns the identical array if array.length <= maxCapacity. Otherwise, returns a new array with a length of maxCapacity containing the first maxCapacity elements of array.

      Parameters:
      maxCapacity - the desired maximum capacity.

    • trimToCapacity

      public static double[] trimToCapacity​(double[] array, int maxCapacity)
      Ensures that the specified array cannot hold more than maxCapacity elements. An application can use this operation to minimize array storage.

      Returns the identical array if array.length <= maxCapacity. Otherwise, returns a new array with a length of maxCapacity containing the first maxCapacity elements of array.

      Parameters:
      maxCapacity - the desired maximum capacity.

    • trimToCapacity

      public static float[] trimToCapacity​(float[] array, int maxCapacity)
      Ensures that the specified array cannot hold more than maxCapacity elements. An application can use this operation to minimize array storage.

      Returns the identical array if array.length <= maxCapacity. Otherwise, returns a new array with a length of maxCapacity containing the first maxCapacity elements of array.

      Parameters:
      maxCapacity - the desired maximum capacity.

    • trimToCapacity

      public static int[] trimToCapacity​(int[] array, int maxCapacity)
      Ensures that the specified array cannot hold more than maxCapacity elements. An application can use this operation to minimize array storage.

      Returns the identical array if array.length <= maxCapacity. Otherwise, returns a new array with a length of maxCapacity containing the first maxCapacity elements of array.

      Parameters:
      maxCapacity - the desired maximum capacity.

    • trimToCapacity

      public static long[] trimToCapacity​(long[] array, int maxCapacity)
      Ensures that the specified array cannot hold more than maxCapacity elements. An application can use this operation to minimize array storage.

      Returns the identical array if array.length <= maxCapacity. Otherwise, returns a new array with a length of maxCapacity containing the first maxCapacity elements of array.

      Parameters:
      maxCapacity - the desired maximum capacity.

    • trimToCapacity

      public static Object[] trimToCapacity​(Object[] array, int maxCapacity)
      Ensures that the specified array cannot hold more than maxCapacity elements. An application can use this operation to minimize array storage.

      Returns the identical array if array.length <= maxCapacity. Otherwise, returns a new array with a length of maxCapacity containing the first maxCapacity elements of array.

      Parameters:
      maxCapacity - the desired maximum capacity.

    • trimToCapacity

      public static short[] trimToCapacity​(short[] array, int maxCapacity)
      Ensures that the specified array cannot hold more than maxCapacity elements. An application can use this operation to minimize array storage.

      Returns the identical array if array.length <= maxCapacity. Otherwise, returns a new array with a length of maxCapacity containing the first maxCapacity elements of array.

      Parameters:
      maxCapacity - the desired maximum capacity.

    • trimToCapacity

      public static boolean[] trimToCapacity​(boolean[] array, int maxCapacity)
      Ensures that the specified array cannot hold more than maxCapacity elements. An application can use this operation to minimize array storage.

      Returns the identical array if array.length <= maxCapacity. Otherwise, returns a new array with a length of maxCapacity containing the first maxCapacity elements of array.

      Parameters:
      maxCapacity - the desired maximum capacity.