Package com.google.api.client.util
Class Lists
java.lang.Object
com.google.api.client.util.Lists
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 Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic <E> ArrayList
<E> Returns a new mutable, emptyArrayList
instance.static <E> ArrayList
<E> newArrayList
(Iterable<? extends E> elements) Returns a new mutableArrayList
instance containing the given elements.static <E> ArrayList
<E> newArrayList
(Iterator<? extends E> elements) Returns a new mutableArrayList
instance containing the given elements.static <E> ArrayList
<E> newArrayListWithCapacity
(int initialArraySize) Creates anArrayList
instance backed by an array of the exact size specified; equivalent toArrayList(int)
.
-
Constructor Details
-
Lists
private Lists()
-
-
Method Details
-
newArrayList
Returns a new mutable, emptyArrayList
instance. -
newArrayListWithCapacity
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:
IllegalArgumentException
- ifinitialArraySize
is negative
-
newArrayList
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
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
-