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
See Also:
  • Constructor Summary

    Constructors
    Modifier
    Constructor
    Description
    protected
    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.