Class Lists

java.lang.Object
com.google.api.client.util.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
  • Constructor Details

    • Lists

      private Lists()
  • Method Details

    • 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