org.josef.util

Class CArray

java.lang.Object

org.josef.util.CArray

@Status(stage=PRODUCTION,
        unitTests=COMPLETE)
 @Review(by="Kees Schotanus",
        at="2009-09-28")
public final class CArray
extends Object

Array utility class.
Besides the utility methods, this class contains constants for empty arrays, to prevent multiple instances of empty arrays of the same type.

Version:

1.0 $Revision: 5877 $

Author:

Kees Schotanus

Field Summary

Fields

Modifier and Type	Field and Description
static Class<?>[]	EMPTY_ARRAY_OF_CLASSES Empty array of Classes.
static Field[]	EMPTY_ARRAY_OF_FIELDS Empty array of Fields.
static Method[]	EMPTY_ARRAY_OF_METHODS Empty array of Methods.
static Object[]	EMPTY_ARRAY_OF_OBJECTS Empty array of Objects.
static double[]	EMPTY_ARRAY_OF_PRIMITIVE_DOUBLES Empty array of primitive doubles.
static String[]	EMPTY_ARRAY_OF_STRINGS Empty array of Strings.

Method Summary

Modifier and Type	Method and Description
static String	arrayToString(Object array) Creates a String representation of the supplied array.
static <T> T[]	concat(T[] firstArray, T[] secondArray) Concatenates two arrays.

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY_ARRAY_OF_FIELDS

public static final Field[] EMPTY_ARRAY_OF_FIELDS

Empty array of Fields.

EMPTY_ARRAY_OF_METHODS

public static final Method[] EMPTY_ARRAY_OF_METHODS

Empty array of Methods.

EMPTY_ARRAY_OF_CLASSES

public static final Class<?>[] EMPTY_ARRAY_OF_CLASSES

Empty array of Classes.

EMPTY_ARRAY_OF_OBJECTS

public static final Object[] EMPTY_ARRAY_OF_OBJECTS

Empty array of Objects.

EMPTY_ARRAY_OF_STRINGS

public static final String[] EMPTY_ARRAY_OF_STRINGS

Empty array of Strings.

EMPTY_ARRAY_OF_PRIMITIVE_DOUBLES

public static final double[] EMPTY_ARRAY_OF_PRIMITIVE_DOUBLES

Empty array of primitive doubles.

Method Detail

concat

public static <T> T[] concat(T[] firstArray,
                             T[] secondArray)

Concatenates two arrays.
As an optimization, this method only returns a new array when both the supplied arrays are non-empty.

Type Parameters:

T - The type of both arrays.

Parameters:

firstArray - The first array.

secondArray - The second array.

Returns:

The concatenation of both supplied arrays.

Throws:

NullPointerException - When either the firstArray or secondArray is null.

arrayToString

public static String arrayToString(Object array)

Creates a String representation of the supplied array.
Normally you will want to use: Arrays.deepToString(...) but this method handles the case where you have an Object reference to an array.

Parameters:

array - The array to create a String representation of.

Returns:

A String representation of the supplied array.

Throws:

IllegalArgumentException - When the supplied array is not actually an array.

See Also:

Arrays.deepToString(Object[])