Class Lists (1.45.0)

public final class Lists

Static utility methods pertaining to List instances.

NOTE: this is a copy of a subset of Guava's com.google.common.collect.Lists. The implementation must match as closely as possible to Guava's implementation.

Inheritance

java.lang.Object > Lists

Static Methods

<E>newArrayList()

public static ArrayList<E> <E>newArrayList()

Returns a new mutable, empty ArrayList instance.

Returns
Type Description
ArrayList<E>

<E>newArrayList(Iterable<? extends E> elements)

public static ArrayList<E> <E>newArrayList(Iterable<? extends E> elements)

Returns a new mutable ArrayList instance containing the given elements.

Parameter
Name Description
elements Iterable<? extends E>

the elements that the list should contain, in order

Returns
Type Description
ArrayList<E>

a new ArrayList containing those elements

<E>newArrayList(Iterator<? extends E> elements)

public static ArrayList<E> <E>newArrayList(Iterator<? extends E> elements)

Returns a new mutable ArrayList instance containing the given elements.

Parameter
Name Description
elements Iterator<? extends E>

the elements that the list should contain, in order

Returns
Type Description
ArrayList<E>

a new ArrayList containing those elements

<E>newArrayListWithCapacity(int initialArraySize)

public static ArrayList<E> <E>newArrayListWithCapacity(int initialArraySize)

Creates an ArrayList instance backed by an array of the exact size specified; equivalent to ArrayList#ArrayList(int).

Parameter
Name Description
initialArraySize int

the exact size of the initial backing array for the returned array list (ArrayList documentation calls this value the "capacity")

Returns
Type Description
ArrayList<E>

a new, empty ArrayList which is guaranteed not to resize itself unless its size reaches initialArraySize + 1