ArrayUtils (Apache Juneau 7.1.1)

java.lang.Object
- org.apache.juneau.internal.ArrayUtils

```
public final class ArrayUtils
extends Object
```
Quick and dirty utilities for working with arrays.

Constructor Summary

Constructors
Constructor and Description

ArrayUtils()

Constructors
Constructor and Description
`ArrayUtils()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static <T> T[]`	`append(T[] array, Collection<T> newElements)` Appends one or more elements to an array.
`static <T> T[]`	`append(T[] array, T... newElements)` Appends one or more elements to an array.
`static <T> Set<T>`	`asSet(T[] array)` Converts the specified array to a `Set`.
`static <T> T[]`	`combine(T[]... arrays)` Combine an arbitrary number of arrays into a single array.
`static boolean`	`contains(String element, String[] array)` Returns true if the specified array contains the specified element using the `String.equals(Object)` method.
`static <T> boolean`	`contains(T element, T[] array)` Returns true if the specified array contains the specified element using the `Object.equals(Object)` method.
`static List`	`copyToList(Object array, List list)` Copies the specified array into the specified list.
`static boolean`	`equals(String[] a1, String[] a2)` Returns true if the following sorted arrays are equals.
`static Object`	`getFirst(Object val)` Returns the first object in the specified collection or array.
`static int`	`indexOf(String element, String[] array)` Returns the index position of the element in the specified array using the `String.equals(Object)` method.
`static <T> int`	`indexOf(T element, T[] array)` Returns the index position of the element in the specified array using the `Object.equals(Object)` method.
`static boolean`	`isArray(Object array)` Returns true if the specified object is an array.
`static Iterator<Object>`	`iterator(Object array)` Returns an iterator against an array.
`static <T> T[]`	`reverse(T[] array)` Creates a new array with reversed entries.
`static <T> T[]`	`reverseInline(T[] array)` Sorts the elements in an array without creating a new array.
`static <T> Object`	`toArray(Collection<?> c, Class<T> componentType)` Converts the specified collection to an array.
`static List<?>`	`toList(Iterable<?> i)` Converts an Iterable to a list.
`static <T> List<T>`	`toList(Object array, Class<T> componentType)` Converts the specified array to an `ArrayList`
`static <T> T[]`	`toObjectArray(Collection<?> c, Class<T> componentType)` Shortcut for calling `myList.toArray(new T[myList.size()]);`
`static Object`	`toPrimitiveArray(Object o)` Converts a primitive wrapper array (e.g.
`static <T> T[]`	`toReverseArray(Class<T> c, Collection<T> l)` Converts a collection to an array containing the elements in reversed order.
`static String[]`	`toStringArray(Collection<?> c)` Converts the specified collection to an array of strings.

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
  - append
```
public static <T> T[] append(T[] array,
                             T... newElements)
```
    Appends one or more elements to an array.
    
    Type Parameters:
    
    T - The element type.
    
    Parameters:
    
    array - The array to append to.
    
    newElements - The new elements to append to the array.
    
    Returns:
    
    A new array with the specified elements appended.
  - append
```
public static <T> T[] append(T[] array,
                             Collection<T> newElements)
```
    Appends one or more elements to an array.
    
    Type Parameters:
    
    T - The element type.
    
    Parameters:
    
    array - The array to append to.
    
    newElements - The new elements to append to the array.
    
    Returns:
    
    A new array with the specified elements appended.
  - combine
```
public static <T> T[] combine(T[]... arrays)
```
    Combine an arbitrary number of arrays into a single array.
    
    Parameters:
    
    arrays - Collection of arrays to combine.
    
    Returns:
    
    A new combined array, or null if all arrays are null.
  - reverse
```
public static <T> T[] reverse(T[] array)
```
    Creates a new array with reversed entries.
    
    Type Parameters:
    
    T - The class type of the array.
    
    Parameters:
    
    array - The array to reverse.
    
    Returns:
    
    A new array with reversed entries, or null if the array was null.
  - reverseInline
```
public static <T> T[] reverseInline(T[] array)
```
    Sorts the elements in an array without creating a new array.
    
    Parameters:
    
    array - The array to sort.
    
    Returns:
    
    The same array.
  - asSet
```
public static <T> Set<T> asSet(T[] array)
```
    Converts the specified array to a Set.
    The order of the entries in the set are the same as the array.
    
    Type Parameters:
    
    T - The entry type of the array.
    
    Parameters:
    
    array - The array being wrapped in a Set interface.
    
    Returns:
    
    The new set.
  - iterator
```
public static Iterator<Object> iterator(Object array)
```
    Returns an iterator against an array.
    This works with any array type (e.g. String[], Object[], int[], etc...).
    
    Parameters:
    
    array - The array to create an iterator over.
    
    Returns:
    
    An iterator over the specified array.
  - toArray
```
public static <T> Object toArray(Collection<?> c,
                                 Class<T> componentType)
```
    Converts the specified collection to an array.
    Works on both object and primitive arrays.
    
    Parameters:
    
    c - The collection to convert to an array.
    
    componentType - The component type of the collection.
    
    Returns:
    
    A new array.
  - isArray
```
public static boolean isArray(Object array)
```
    Returns true if the specified object is an array.
    
    Parameters:
    
    array - The array to test.
    
    Returns:
    
    true if the specified object is an array.
  - toList
```
public static <T> List<T> toList(Object array,
                                 Class<T> componentType)
```
    Converts the specified array to an ArrayList
    
    Parameters:
    
    array - The array to convert.
    
    componentType - The type of objects in the array. It must match the actual component type in the array.
    
    Returns:
    
    A new ArrayList
  - toObjectArray
```
public static <T> T[] toObjectArray(Collection<?> c,
                                    Class<T> componentType)
```
    Shortcut for calling myList.toArray(new T[myList.size()]);
    
    Parameters:
    
    c - The collection being converted to an array.
    
    componentType - The component type of the array.
    
    Returns:
    
    The collection converted to an array.
  - copyToList
```
public static List copyToList(Object array,
                              List list)
```
    Copies the specified array into the specified list.
    Works on both object and primitive arrays.
    
    Parameters:
    
    array - The array to copy into a list.
    
    list - The list to copy the values into.
    
    Returns:
    
    The same list passed in.
  - contains
```
public static <T> boolean contains(T element,
                                   T[] array)
```
    Returns true if the specified array contains the specified element using the Object.equals(Object) method.
    
    Parameters:
    
    element - The element to check for.
    
    array - The array to check.
    
    Returns:
    
    true if the specified array contains the specified element, false if the array or element is null.
  - indexOf
```
public static <T> int indexOf(T element,
                              T[] array)
```
    Returns the index position of the element in the specified array using the Object.equals(Object) method.
    
    Parameters:
    
    element - The element to check for.
    
    array - The array to check.
    
    Returns:
    
    The index position of the element in the specified array, or -1 if the array doesn't contain the element, or the array or element is null.
  - contains
```
public static boolean contains(String element,
                               String[] array)
```
    Returns true if the specified array contains the specified element using the String.equals(Object) method.
    
    Parameters:
    
    element - The element to check for.
    
    array - The array to check.
    
    Returns:
    
    true if the specified array contains the specified element, false if the array or element is null.
  - indexOf
```
public static int indexOf(String element,
                          String[] array)
```
    Returns the index position of the element in the specified array using the String.equals(Object) method.
    
    Parameters:
    
    element - The element to check for.
    
    array - The array to check.
    
    Returns:
    
    The index position of the element in the specified array, or -1 if the array doesn't contain the element, or the array or element is null.
  - toPrimitiveArray
```
public static Object toPrimitiveArray(Object o)
```
    Converts a primitive wrapper array (e.g. Integer[]) to a primitive array (e.g. int[]).
    
    Parameters:
    
    o - The array to convert. Must be a primitive wrapper array.
    
    Returns:
    
    A new array.
    
    Throws:
    
    IllegalArgumentException - If object is not a wrapper object array.
  - toList
```
public static List<?> toList(Iterable<?> i)
```
    Converts an Iterable to a list.
    
    Parameters:
    
    i - The iterable to convert.
    
    Returns:
    
    A new list of objects copied from the iterable.
  - getFirst
```
public static Object getFirst(Object val)
```
    Returns the first object in the specified collection or array.
    
    Parameters:
    
    val - The collection or array object.
    
    Returns:
    
    The first object, or null if the collection or array is empty or null or the value isn't a collection or array.
  - toStringArray
```
public static String[] toStringArray(Collection<?> c)
```
    Converts the specified collection to an array of strings.
    Entries are converted to strings using Object.toString(). null values remain null.
    
    Parameters:
    
    c - The collection to convert.
    
    Returns:
    
    The collection as a string array.
  - equals
```
public static boolean equals(String[] a1,
                             String[] a2)
```
    Returns true if the following sorted arrays are equals.
    
    Parameters:
    
    a1 - Array #1.
    
    a2 - Array #2.
    
    Returns:
    
    true if the following sorted arrays are equals.
  - toReverseArray
```
public static <T> T[] toReverseArray(Class<T> c,
                                     Collection<T> l)
```
    Converts a collection to an array containing the elements in reversed order.
    
    Parameters:
    
    c - The component type of the array.
    
    l - The collection to convert.
    The collection is not modified.
    
    Returns:
    
    A new array, or null if the collection was null.

Class ArrayUtils

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

ArrayUtils

Method Detail

append

append

combine

reverse

reverseInline

asSet

iterator

toArray

isArray

toList

toObjectArray

copyToList

contains

indexOf

contains

indexOf

toPrimitiveArray

toList

getFirst

toStringArray

equals

toReverseArray