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 Summary

Constructors

Modifier	Constructor	Description
private	Lists()

Method Summary

Modifier and Type	Method	Description
static <E> ArrayList<E>	newArrayList()	Returns a new mutable, empty ArrayList instance.
static <E> ArrayList<E>	newArrayList(Iterable<? extends E> elements)	Returns a new mutable ArrayList instance containing the given elements.
static <E> ArrayList<E>	newArrayList(Iterator<? extends E> elements)	Returns a new mutable ArrayList instance containing the given elements.
static <E> ArrayList<E>	newArrayListWithCapacity(int initialArraySize)	Creates an ArrayList instance backed by an array of the exact size specified; equivalent to ArrayList(int).

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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