Class ListBuffer<A>

java.lang.Object

java.util.AbstractCollection<A>

java.util.AbstractQueue<A>

com.strobel.collections.ListBuffer<A>

All Implemented Interfaces:

Iterable<A>, Collection<A>, Queue<A>

public class ListBuffer<A>
extends AbstractQueue<A>

A class for constructing lists by appending elements. Modelled after java.lang.StringBuffer.

This is NOT part of any supported API. If you write code that depends on this, you do so at your own risk. This code and its internal interfaces are subject to change or deletion without notice.

Field Summary

Fields

Modifier and Type	Field	Description
int	count	The number of element in this buffer.
ImmutableList<A>	elements	The list of elements of this buffer.
ImmutableList<A>	last	A pointer pointing to the last, sentinel element of `elements'.
boolean	shared	Has a list been created from this buffer yet?

Constructor Summary

Constructors

Constructor	Description
ListBuffer()	Create a new initially empty list buffer.

Method Summary

Modifier and Type	Method	Description
boolean	add(A a)
boolean	addAll(Collection<? extends A> c)
ListBuffer<A>	append(A x)	Append an element to buffer.
ListBuffer<A>	appendArray(A[] xs)	Append all elements in an array to buffer.
ListBuffer<A>	appendList(ImmutableList<A> xs)	Append all elements in a list to buffer.
ListBuffer<A>	appendList(ListBuffer<A> xs)	Append all elements in a list to buffer.
final void	clear()
boolean	contains(Object x)	Does the list contain the specified element?
boolean	containsAll(Collection<?> c)
private void	copy()	Copy list and sets last.
A	first()	The first element in this buffer.
boolean	isEmpty()	Is buffer empty?
Iterator<A>	iterator()	An enumeration of all elements in this buffer.
static <T> ListBuffer<T>	lb()
int	length()	Return the number of elements in this buffer.
A	next()	Return first element in this buffer and remove
boolean	nonEmpty()	Is buffer not empty?
static <T> ListBuffer<T>	of(T x)
boolean	offer(A a)
A	peek()
A	poll()
ListBuffer<A>	prepend(A x)	Prepend an element to buffer.
boolean	remove(Object o)
boolean	removeAll(Collection<?> c)
boolean	retainAll(Collection<?> c)
int	size()
Object[]	toArray()
<T> T[]	toArray(T[] vec)	Convert buffer to an array
ImmutableList<A>	toList()	Convert buffer to a list of all its elements.

Methods inherited from class AbstractQueue

element, remove

Methods inherited from class AbstractCollection

toString

Methods inherited from class Object

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

Methods inherited from interface Collection

equals, hashCode, parallelStream, removeIf, spliterator, stream, toArray

Methods inherited from interface Iterable

forEach

Field Details

elements

public ImmutableList<A> elements

The list of elements of this buffer.

last

public ImmutableList<A> last

A pointer pointing to the last, sentinel element of `elements'.

count

public int count

The number of element in this buffer.

shared

public boolean shared

Has a list been created from this buffer yet?

Constructor Details

ListBuffer

public ListBuffer()

Create a new initially empty list buffer.

Method Details

lb

public static <T> ListBuffer<T> lb()

of

public static <T> ListBuffer<T> of(T x)

clear

public final void clear()

Specified by:

clear in interface Collection<A>

Overrides:

clear in class AbstractQueue<A>

length

public int length()

Return the number of elements in this buffer.

size

public int size()

Specified by:

size in interface Collection<A>

Specified by:

size in class AbstractCollection<A>

isEmpty

public boolean isEmpty()

Is buffer empty?

Specified by:

isEmpty in interface Collection<A>

Overrides:

isEmpty in class AbstractCollection<A>

nonEmpty

public boolean nonEmpty()

Is buffer not empty?

copy

private void copy()

Copy list and sets last.

prepend

public ListBuffer<A> prepend(A x)

Prepend an element to buffer.

append

public ListBuffer<A> append(A x)

Append an element to buffer.

appendList

public ListBuffer<A> appendList(ImmutableList<A> xs)

Append all elements in a list to buffer.

appendList

public ListBuffer<A> appendList(ListBuffer<A> xs)

Append all elements in a list to buffer.

appendArray

public ListBuffer<A> appendArray(A[] xs)

Append all elements in an array to buffer.

toList

public ImmutableList<A> toList()

Convert buffer to a list of all its elements.

contains

public boolean contains(Object x)

Does the list contain the specified element?

Specified by:

contains in interface Collection<A>

Overrides:

contains in class AbstractCollection<A>

toArray

@NotNull
public <T> T[] toArray(T[] vec)

Convert buffer to an array

Specified by:

toArray in interface Collection<A>

Overrides:

toArray in class AbstractCollection<A>

toArray

@NotNull
public Object[] toArray()

Specified by:

toArray in interface Collection<A>

Overrides:

toArray in class AbstractCollection<A>

first

public A first()

The first element in this buffer.

next

public A next()

Return first element in this buffer and remove

iterator

@NotNull
public Iterator<A> iterator()

An enumeration of all elements in this buffer.

Specified by:

iterator in interface Collection<A>

Specified by:

iterator in interface Iterable<A>

Specified by:

iterator in class AbstractCollection<A>

add

public boolean add(A a)

Specified by:

add in interface Collection<A>

Specified by:

add in interface Queue<A>

Overrides:

add in class AbstractQueue<A>

remove

public boolean remove(Object o)

Specified by:

remove in interface Collection<A>

Overrides:

remove in class AbstractCollection<A>

containsAll

public boolean containsAll(Collection<?> c)

Specified by:

containsAll in interface Collection<A>

Overrides:

containsAll in class AbstractCollection<A>

addAll

public boolean addAll(Collection<? extends A> c)

Specified by:

addAll in interface Collection<A>

Overrides:

addAll in class AbstractQueue<A>

removeAll

public boolean removeAll(Collection<?> c)

Specified by:

removeAll in interface Collection<A>

Overrides:

removeAll in class AbstractCollection<A>

retainAll

public boolean retainAll(Collection<?> c)

Specified by:

retainAll in interface Collection<A>

Overrides:

retainAll in class AbstractCollection<A>

offer

public boolean offer(A a)

poll

public A poll()

peek

public A peek()