Package com.google.api.client.util
Class Lists
- java.lang.Object
-
- com.google.api.client.util.Lists
-
public final class Lists extends java.lang.Object
Static utility methods pertaining toList
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 Summary
Constructors Modifier Constructor Description private
Lists()
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static <E> java.util.ArrayList<E>
newArrayList()
Returns a new mutable, emptyArrayList
instance.static <E> java.util.ArrayList<E>
newArrayList(java.lang.Iterable<? extends E> elements)
Returns a new mutableArrayList
instance containing the given elements.static <E> java.util.ArrayList<E>
newArrayList(java.util.Iterator<? extends E> elements)
Returns a new mutableArrayList
instance containing the given elements.static <E> java.util.ArrayList<E>
newArrayListWithCapacity(int initialArraySize)
Creates anArrayList
instance backed by an array of the exact size specified; equivalent toArrayList(int)
.
-
-
-
Method Detail
-
newArrayList
public static <E> java.util.ArrayList<E> newArrayList()
Returns a new mutable, emptyArrayList
instance.
-
newArrayListWithCapacity
public static <E> java.util.ArrayList<E> newArrayListWithCapacity(int initialArraySize)
Creates anArrayList
instance backed by an array of the exact size specified; equivalent toArrayList(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 reachesinitialArraySize + 1
- Throws:
java.lang.IllegalArgumentException
- ifinitialArraySize
is negative
-
newArrayList
public static <E> java.util.ArrayList<E> newArrayList(java.lang.Iterable<? extends E> elements)
Returns a new mutableArrayList
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> java.util.ArrayList<E> newArrayList(java.util.Iterator<? extends E> elements)
Returns a new mutableArrayList
instance containing the given elements.- Parameters:
elements
- the elements that the list should contain, in order- Returns:
- a new
ArrayList
containing those elements
-
-