com.diffplug.common.collect

Class ObjectArrays

java.lang.Object

com.diffplug.common.collect.ObjectArrays

@GwtCompatible(emulated=true)
public final class ObjectArrays
extends Object

Static utility methods pertaining to object arrays.

Since:

2.0

Method Summary

Modifier and Type	Method and Description
static <T> T[]	concat(T[] array, T element) Returns a new array that appends element to array.
static <T> T[]	concat(T[] first, T[] second, Class<T> type) Returns a new array that contains the concatenated contents of two arrays.
static <T> T[]	concat(T element, T[] array) Returns a new array that prepends element to array.
static <T> T[]	newArray(Class<T> type, int length) Returns a new array of the given length with the specified component type.
static <T> T[]	newArray(T[] reference, int length) Returns a new array of the given length with the same type as a reference array.

Methods inherited from class java.lang.Object

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

Method Detail

newArray

@GwtIncompatible(value="Array.newInstance(Class, int)")
public static <T> T[] newArray(Class<T> type,
                                                                                       int length)

Returns a new array of the given length with the specified component type.

Parameters:

type - the component type

length - the length of the new array

newArray

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

Returns a new array of the given length with the same type as a reference array.

Parameters:

reference - any array of the desired type

length - the length of the new array

concat

@GwtIncompatible(value="Array.newInstance(Class, int)")
public static <T> T[] concat(T[] first,
                                                                                     T[] second,
                                                                                     Class<T> type)

Returns a new array that contains the concatenated contents of two arrays.

Parameters:

first - the first array of elements to concatenate

second - the second array of elements to concatenate

type - the component type of the returned array

concat

public static <T> T[] concat(@Nullable
                             T element,
                             T[] array)

Returns a new array that prepends element to array.

Parameters:

element - the element to prepend to the front of array

array - the array of elements to append

Returns:

an array whose size is one larger than array, with element occupying the first position, and the elements of array occupying the remaining elements.

concat

public static <T> T[] concat(T[] array,
                             @Nullable
                             T element)

Returns a new array that appends element to array.

Parameters:

array - the array of elements to prepend

element - the element to append to the end

Returns:

an array whose size is one larger than array, with the same contents as array, plus element occupying the last position.