com.google.api.client.util

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

Author:

Yaniv Inbar

Method Summary

Modifier and Type	Method and 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.ArrayList(int).

Methods inherited from class java.lang.Object

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

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