Class Lists


  • public final class Lists
    extends Object
    Static utility methods pertaining to List instances.

    NOTE: this is a copy of a subset of Guava's Lists. The implementation must match as closely as possible to Guava's implementation.

    Since:
    1.14
    Author:
    Yaniv Inbar
    • Method Detail

      • newArrayList

        public static <E> ArrayList<E> newArrayList()
        Returns a new mutable, empty ArrayList instance.
      • newArrayListWithCapacity

        public static <E> ArrayList<E> newArrayListWithCapacity​(int initialArraySize)
        Creates an ArrayList instance backed by an array of the exact size specified; equivalent to ArrayList(int).
        Parameters:
        initialArraySize - the exact size of the initial backing array for the returned array list (ArrayList documentation calls this value the "capacity")
        Returns:
        a new, empty ArrayList which is guaranteed not to resize itself unless its size reaches initialArraySize + 1
        Throws:
        IllegalArgumentException - if initialArraySize is negative
      • newArrayList

        public static <E> ArrayList<E> newArrayList​(Iterable<? extends E> elements)
        Returns a new mutable ArrayList instance containing the given elements.
        Parameters:
        elements - the elements that the list should contain, in order
        Returns:
        a new ArrayList containing those elements
      • newArrayList

        public static <E> ArrayList<E> newArrayList​(Iterator<? extends E> elements)
        Returns a new mutable ArrayList instance containing the given elements.
        Parameters:
        elements - the elements that the list should contain, in order
        Returns:
        a new ArrayList containing those elements