org.rhq.core.clientapi.util
Class ArrayUtil

java.lang.Object
  org.rhq.core.clientapi.util.ArrayUtil

public class ArrayUtil
extends Object

Constructor Summary

ArrayUtil()

Method Summary

static double	average(double[] values) Get the average of an array of values.
static Object[]	combine(Object[] a1, Object[] a2) Combine two arrays into a single, larger array.
static void	dumpArray(PrintStream out, Object[] array)
static boolean	equals(Object[] a1, Object[] a2) Array equality
static boolean	exists(Object[] array, Object element) Return a boolean whether or not the element exists in the array
static int	find(Object[] array, Object element) Find the index of the first appearance of an object in the array
static int	findMinDiff(double[] values) Find the 2 values with the smallest difference between them.
static boolean	isUniq(String[] values) Check to see if a _sorted_ array of values contains all unique values.
static int	max(double[] values) Find the maximum value in an array of double values.
static int	max(int[] values) Find the maximum value in an array of int values.
static Object[]	merge(Object[][] arrays, Object[] arrType)
static Object[]	merge(Object[] one, Object[] two, Object[] arrType)
static int	min(double[] values) Find the minimum value in an array of double values.
static int[]	stringToInt(String[] array) Convert a string array to an array of int.
static Integer[]	stringToInteger(String[] array) Convert a string array to an array of Integer.
static double[]	uniq(double[] values) Return an array of values where every value is unique.

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

dumpArray

public static void dumpArray(PrintStream out,
                             Object[] array)

merge

public static Object[] merge(Object[][] arrays,
                             Object[] arrType)

merge

public static Object[] merge(Object[] one,
                             Object[] two,
                             Object[] arrType)

max

public static int max(double[] values)

Find the maximum value in an array of double values.

Parameters:

values - Values to search for to find the max of

Returns:

The index of the maximum value, or -1 if 'values' was 0 length

max

public static int max(int[] values)

Find the maximum value in an array of int values.

Parameters:

values - Values to search for to find the max of

Returns:

The index of the maximum value, or -1 if 'values' was 0 length

min

public static int min(double[] values)

Find the minimum value in an array of double values.

Parameters:

values - Values to search for to find the min of

Returns:

The index of the minimum value, or -1 if 'values' was 0 length

average

public static double average(double[] values)

Get the average of an array of values.

uniq

public static double[] uniq(double[] values)

Return an array of values where every value is unique.

Parameters:

values - Values to get the unique of. Note that this array _must_ be sorted, prior to invoking this method

Returns:

a new array with values represented in the 'values' argument only a single time each

isUniq

public static boolean isUniq(String[] values)

Check to see if a _sorted_ array of values contains all unique values.

equals

public static boolean equals(Object[] a1,
                             Object[] a2)

Array equality

Returns:

true if both arrays contain elements in the same positions that are also equal. Returns false if either (or both) arrays are null;

findMinDiff

public static int findMinDiff(double[] values)

Find the 2 values with the smallest difference between them. In the case of a tie, the earlier value in the array will be returned. Ex: findMinDiff({1, 2, 3, 4, 5}) -> 0 findMinDiff({1, 2, 2.2, 3, 4, 5}) -> 1

Parameters:

values - An array of _sorted_, _unique_ values

Returns:

The index of the first number in the pair with the smallest difference.

exists

public static boolean exists(Object[] array,
                             Object element)

Return a boolean whether or not the element exists in the array

Parameters:

array - An array of objects

element - The element to look for in the array

Returns:

true if element is in the array

find

public static int find(Object[] array,
                       Object element)

Find the index of the first appearance of an object in the array

stringToInteger

public static Integer[] stringToInteger(String[] array)

Convert a string array to an array of Integer. If array is null, null will be returned.

Parameters:

array - string array

Returns:

the Integer array

Throws:

NumberFormatException - if an element in the String array is not parseable into an Integer

stringToInt

public static int[] stringToInt(String[] array)

Convert a string array to an array of int. If array is null, null will be returned.

Parameters:

array - string array

Returns:

the int array

Throws:

NumberFormatException - if an element in the String array is not parseable into an int

combine

public static Object[] combine(Object[] a1,
                               Object[] a2)

Combine two arrays into a single, larger array. This method only returns null if both a1 and a2 are null. If a1 is not null, the array that is returned has the same class as a1. Otherwise it will be the the same class as a2.

Parameters:

a1 - The first array. If this is null, a copy of the second array is returned (unless it's null too, then null is returned).

a2 - The second array. If this is null, a copy of the first array is returned (unless it's null too, then null is returned).

Returns:

An array that is effectively a2 appended to a1, or null if both a1 and a2 are null. The class of the array is the same as a1, unless a1 is null in which case the class of the array is the same as a2, unless a2 is also null, in which case this method returns null;