Class ObjectArrays


  • @GwtCompatible(emulated=true)
    public final class ObjectArrays
    extends java.lang.Object
    Static utility methods pertaining to object arrays.
    Since:
    2.0
    Author:
    Kevin Bourrillion
    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static <T extends @Nullable java.lang.Object>
      T[]
      concat​(T[] array, T element)
      Returns a new array that appends element to array.
      static <T> T[] concat​(T[] first, T[] second, java.lang.Class<T> type)
      Returns a new array that contains the concatenated contents of two arrays.
      static <T extends @Nullable java.lang.Object>
      T[]
      concat​(T element, T[] array)
      Returns a new array that prepends element to array.
      static <T> T[] newArray​(java.lang.Class<T> type, int length)
      Returns a new array of the given length with the specified component type.
      static <T extends @Nullable java.lang.Object>
      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
        public static <T> T[] newArray​(java.lang.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 extends @Nullable java.lang.Object> 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
        public static <T> T[] concat​(T[] first,
                                     T[] second,
                                     java.lang.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 extends @Nullable java.lang.Object> T[] concat​(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 extends @Nullable java.lang.Object> T[] concat​(T[] array,
                                                                        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.