de.alpharogroup.collections.array

Class ArrayFactory

java.lang.Object

de.alpharogroup.collections.array.ArrayFactory

public final class ArrayFactory
extends Object

The factory class ArrayFactory provides factory methods for create new Array objects

Constructor Summary

Constructors

Constructor and Description
ArrayFactory()

Method Summary

Modifier and Type	Method and Description
static <T> T[]	newArray(Class<T> cls, int length) Factory method for create new array from the given class type and the given length
static <T> T[]	newArray(T... elements) Factory method for create new array from the given optional elements.
static boolean[]	newBooleanArray(boolean... elements) Factory method for create new array of primitive boolean values from the given optional elements.
static byte[]	newByteArray(byte... elements) Factory method for create new array of primitive byte values from the given optional elements.
static char[]	newCharArray(char... elements) Factory method for create new array of primitive character values from the given optional elements.
static double[]	newDoubleArray(double... elements) Factory method for create new array of primitive double values from the given optional elements.
static <T> T[]	newEmptyArray(T[] array) Factory method for create new empty array with the length of the given array
static <T> T[]	newEmptyArray(T[] array, int length) Factory method for create new empty array with the length of the given array.
static float[]	newFloatArray(float... elements) Factory method for create new array of primitive float values from the given optional elements.
static int[]	newIntArray(int... elements) Factory method for create new array of primitive integer values from the given optional elements.
static long[]	newLongArray(long... elements) Factory method for create new array of primitive long values from the given optional elements.
static Integer[]	newRangeArray(int start, int end) Creates a new Integer array with the given range that is defined through start and end.
static short[]	newShortArray(short... elements) Factory method for create new array of primitive short values from the given optional elements.
static <T> T[]	newSubArray(T[] source, int startIndex, int endIndex) Creates a new partial array from the given source array starting from the given start index that is inclusive and the end index that is exclusive

Methods inherited from class java.lang.Object

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

Constructor Detail

ArrayFactory

public ArrayFactory()

Method Detail

newArray

public static <T> T[] newArray(Class<T> cls,
                               int length)

Factory method for create new array from the given class type and the given length

Type Parameters:

T - the generic type of the elements

Parameters:

cls - the class type

length - the capacity

Returns:

the new array of the given class type and the given length

newArray

@SafeVarargs
public static <T> T[] newArray(T... elements)

Factory method for create new array from the given optional elements.

Type Parameters:

T - the generic type of the elements

Parameters:

elements - the optional elements that will be in the returned array.

Returns:

the new array

newEmptyArray

public static <T> T[] newEmptyArray(@NonNull
                                    T[] array)

Factory method for create new empty array with the length of the given array

Type Parameters:

T - the generic type of the elements

Parameters:

array - the array that is used as a template

Returns:

the new empty array

newEmptyArray

public static <T> T[] newEmptyArray(@NonNull
                                    T[] array,
                                    int length)

Factory method for create new empty array with the length of the given array.

Type Parameters:

T - the generic type of the elements

Parameters:

array - the array that is used as a template

length - the length of the new empty array

Returns:

the new empty array

newRangeArray

public static Integer[] newRangeArray(int start,
                                      int end)

Creates a new Integer array with the given range that is defined through start and end. For instance if the start is 5 and the end is 9 the resulted array will be [5,6,7,8,9]

Parameters:

start - The number to start

end - The number to end minus one

Returns:

the generated Integer array

newBooleanArray

@SafeVarargs
public static boolean[] newBooleanArray(boolean... elements)

Factory method for create new array of primitive boolean values from the given optional elements.

Parameters:

elements - the optional primitive boolean values that will be in the returned array of primitive boolean values array.

Returns:

the new array of primitive boolean values

newByteArray

@SafeVarargs
public static byte[] newByteArray(byte... elements)

Factory method for create new array of primitive byte values from the given optional elements.

Parameters:

elements - the optional primitive byte values that will be in the returned array of primitive byte values array.

Returns:

the new array of primitive byte values

newCharArray

@SafeVarargs
public static char[] newCharArray(char... elements)

Factory method for create new array of primitive character values from the given optional elements.

Parameters:

elements - the optional primitive character values that will be in the returned array of primitive character values array.

Returns:

the new array of primitive character values

newIntArray

@SafeVarargs
public static int[] newIntArray(int... elements)

Factory method for create new array of primitive integer values from the given optional elements.

Parameters:

elements - the optional primitive integer values that will be in the returned array of primitive integer values array.

Returns:

the new array of primitive integer values

newLongArray

@SafeVarargs
public static long[] newLongArray(long... elements)

Factory method for create new array of primitive long values from the given optional elements.

Parameters:

elements - the optional primitive long values that will be in the returned array of primitive long values array.

Returns:

the new array of primitive long values

newFloatArray

@SafeVarargs
public static float[] newFloatArray(float... elements)

Factory method for create new array of primitive float values from the given optional elements.

Parameters:

elements - the optional primitive float values that will be in the returned array of primitive float values array.

Returns:

the new array of primitive float values

newDoubleArray

@SafeVarargs
public static double[] newDoubleArray(double... elements)

Factory method for create new array of primitive double values from the given optional elements.

Parameters:

elements - the optional primitive double values that will be in the returned array of primitive double values array.

Returns:

the new array of primitive double values

newShortArray

@SafeVarargs
public static short[] newShortArray(short... elements)

Factory method for create new array of primitive short values from the given optional elements.

Parameters:

elements - the optional primitive short values that will be in the returned array of primitive short values array.

Returns:

the new array of primitive short values

newSubArray

public static <T> T[] newSubArray(@NonNull
                                  T[] source,
                                  int startIndex,
                                  int endIndex)

Creates a new partial array from the given source array starting from the given start index that is inclusive and the end index that is exclusive

Type Parameters:

T - the generic type

Parameters:

source - the source array

startIndex - the start index that is inclusive

endIndex - the end index that is exclusive

Returns:

the new partial array