com.google.api.client.util

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 com.google.common.collect.Lists. The implementation must match as closely as possible to Guava's implementation.

    Since:
    1.14

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