Package org.apache.juneau.internal

Class ArrayUtils

java.lang.Object
org.apache.juneau.internal.ArrayUtils
public class ArrayUtils extends Object
Quick and dirty utilities for working with arrays.
See Also:

  • Constructor Summary

    Constructors
    Constructor
    Description
    ArrayUtils()
     

  • Method Summary

    Modifier and Type
    Method
    Description
    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 <E> E[]
    combine(E[]... 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> T[]
    copyOf(T[] array)
    Makes a copy of the specified array.
    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 int
    indexOf(String element, String[] array)
    Returns the index position of the element in the specified array using the String.equals(Object) method.
    static boolean
    isEmptyArray(Object[] array)
    Returns true if the specified array is null or has a length of zero.
    static boolean
    isEmptyArray(Object[] array1, Object[] array2)
    Returns true if both specified arrays are null or have a length of zero.
    static boolean
    isNotEmptyArray(Object[] array)
    Returns true if the specified array is not null and has a length greater than zero.
    static <E> E[]
    reverse(E[] array)
    Reverses the entries in an array.
    static <E> Object
    toArray(Collection<?> c, Class<E> elementType)
    Converts the specified collection to an array.
    static <E> List<E>
    toList(Object array, Class<E> elementType)
    Converts the specified array to an ArrayList
    static List<Object>
    toObjectList(Object array)
    Recursively converts the specified array into a list of objects.
    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 Details

  • Method Details

    • 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.

    • combine

      public static <E> E[] combine(E[]... arrays)
      Combine an arbitrary number of arrays into a single array.
      Type Parameters:
      E - The element type.
      Parameters:
      arrays - Collection of arrays to combine.
      Returns:
      A new combined array, or null if all arrays are null.

    • 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.

    • toArray

      public static <E> Object toArray(Collection<?> c, Class<E> elementType)
      Converts the specified collection to an array.

      Works on both object and primitive arrays.

      Type Parameters:
      E - The element type.
      Parameters:
      c - The collection to convert to an array.
      elementType - The component type of the collection.
      Returns:
      A new array.

    • toList

      public static <E> List<E> toList(Object array, Class<E> elementType)
      Converts the specified array to an ArrayList
      Type Parameters:
      E - The element type.
      Parameters:
      array - The array to convert.
      elementType - The type of objects in the array. It must match the actual component type in the array.
      Returns:
      A new ArrayList

    • toObjectList

      public static List<Object> toObjectList(Object array)
      Recursively converts the specified array into a list of objects.
      Parameters:
      array - The array to convert.
      Returns:
      A new ArrayList

    • 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 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.

    • 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.

    • copyOf

      public static <T> T[] copyOf(T[] array)
      Makes a copy of the specified array.
      Type Parameters:
      T - The element type.
      Parameters:
      array - The array to copy.
      Returns:
      A new copy of the array, or null if the array was null.s

    • isNotEmptyArray

      public static boolean isNotEmptyArray(Object[] array)
      Returns true if the specified array is not null and has a length greater than zero.
      Parameters:
      array - The array to check.
      Returns:
      true if the specified array is not null and has a length greater than zero.

    • isEmptyArray

      public static boolean isEmptyArray(Object[] array)
      Returns true if the specified array is null or has a length of zero.
      Parameters:
      array - The array to check.
      Returns:
      true if the specified array is null or has a length of zero.

    • isEmptyArray

      public static boolean isEmptyArray(Object[] array1, Object[] array2)
      Returns true if both specified arrays are null or have a length of zero.
      Parameters:
      array1 - The array to check.
      array2 - The array to check.
      Returns:
      true if the specified array is null or has a length of zero.

    • reverse

      public static <E> E[] reverse(E[] array)
      Reverses the entries in an array.
      Type Parameters:
      E - The element type.
      Parameters:
      array - The array to reverse.
      Returns:
      The same array.