me.croabeast.beanslib.utility

Class ArrayUtils

java.lang.Object

me.croabeast.beanslib.utility.ArrayUtils

public class ArrayUtils
extends Object

A utility class that provides some methods for working with arrays. This class uses generics to handle different types of arrays.

Constructor Summary

Constructors

Constructor and Description
ArrayUtils()

Method Summary

Modifier and Type	Method and Description
<T> T[]	checkArray(T... array) Checks if an array is declared and throws an exception if not.
<T> T[]	combineArrays(T[] array, T[]... extraArrays) Combines an array with one or more additional arrays into a new array of the same type.
<T,R> @NotNull List<R>	fromArray(java.util.function.Function<T,? extends R> function, T... array)
<T> @NotNull List<T>	fromArray(T... array) Converts an array to a list without applying any operator.
<T> @NotNull List<T>	fromArray(java.util.function.UnaryOperator<T> operator, T... array) Converts an array to a list and applies an optional operator to each element.
<T> boolean	isArrayEmpty(T... array) Checks if an array is empty or null.
<T> T[]	toArray(Iterable<? extends T> iterable) Converts an iterable to an array.

Methods inherited from class java.lang.Object

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

Constructor Detail

ArrayUtils

public ArrayUtils()

Method Detail

combineArrays

@SafeVarargs
public <T> T[] combineArrays(@NotNull
                                           T[] array,
                                           T[]... extraArrays)

Combines an array with one or more additional arrays into a new array of the same type.

Type Parameters:

T - the type of the elements in the arrays

Parameters:

array - the first array to be combined

extraArrays - the other arrays to be combined

Returns:

a new array that contains all the elements from the given arrays

Since:

1.3

isArrayEmpty

@SafeVarargs
public <T> boolean isArrayEmpty(T... array)

Checks if an array is empty or null.

Type Parameters:

T - the type of the elements in the array

Parameters:

array - the array to be checked

Returns:

true if the array is empty or null, false otherwise

checkArray

@SafeVarargs
public <T> T[] checkArray(T... array)

Checks if an array is declared and throws an exception if not.

Type Parameters:

T - the type of the elements in the array

Parameters:

array - the array to be checked

Returns:

the same array if it is declared

Throws:

IllegalArgumentException - if the array is null or has zero length

fromArray

@SafeVarargs
 @NotNull
public <T> @NotNull List<T> fromArray(java.util.function.UnaryOperator<T> operator,
                                                               T... array)

Converts an array to a list and applies an optional operator to each element.

Type Parameters:

T - the type of the elements in the array and the list

Parameters:

operator - the operator to be applied to each element, can be null

array - the array to be converted

Returns:

a new list that contains the elements from the array after applying the operator

Throws:

IllegalArgumentException - if the array is null or has zero length

fromArray

@SafeVarargs
 @NotNull
public <T> @NotNull List<T> fromArray(T... array)

Converts an array to a list without applying any operator.

Type Parameters:

T - the type of the elements in the array and the list

Parameters:

array - the array to be converted

Returns:

a new list that contains the same elements as the array

Throws:

IllegalArgumentException - if the array is null or has zero length

fromArray

@SafeVarargs
 @NotNull
public <T,R> @NotNull List<R> fromArray(java.util.function.Function<T,? extends R> function,
                                                                 T... array)

toArray

public <T> T[] toArray(Iterable<? extends T> iterable)

Converts an iterable to an array.

Type Parameters:

T - the type of the elements in the iterable and the array

Parameters:

iterable - the iterable to be converted

Returns:

a new array that contains the elements from the iterable

Throws:

NullPointerException - if the iterable is null