org.incava.ijdk.lang

Interface Sequence<T>

All Superinterfaces:

java.util.Collection<T>, java.lang.Iterable<T>, java.util.List<T>

All Known Implementing Classes:

Array, IntegerList, StringList, StringList, Versions

public interface Sequence<T>
extends java.util.List<T>

A list with extended functionality, modeled on the Enumerable class in Ruby.

Method Summary

Modifier and Type	Method and Description
Sequence<T>	append(T element) Adds the given element, and returns a sequence, so this method call can be chained into multiple ones.
Sequence<T>	compact() Returns a new sequence that contains only the non-null elements from this sequence, in the same order as in this sequence.
T	first() Returns the first element in the sequence.
java.lang.String	join(java.lang.String delimiter) Returns the sequence as a String, joined by the delimiter.
T	last() Returns the last element in the sequence.
T	takeFirst() Removes and returns the first element in the sequence.
T	takeLast() Removes and returns the last element in the sequence.
Sequence<T>	unique() Returns a new sequence that contains unique elements from the sequence, in the same order as in this one.

Methods inherited from interface java.util.List

add, add, addAll, addAll, clear, contains, containsAll, equals, get, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, replaceAll, retainAll, set, size, sort, spliterator, subList, toArray, toArray

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Methods inherited from interface java.lang.Iterable

forEach

Method Detail

append

Sequence<T> append(T element)

Adds the given element, and returns a sequence, so this method call can be chained into multiple ones. The returned sequence could be either this object, or a newly-created object.

first

T first()

Returns the first element in the sequence.

last

T last()

Returns the last element in the sequence.

takeFirst

T takeFirst()

Removes and returns the first element in the sequence. Returns null if the sequence is empty.

Returns:

the first element

takeLast

T takeLast()

Removes and returns the last element in the sequence. Returns null if the sequence is empty.

Returns:

the last element

unique

Sequence<T> unique()

Returns a new sequence that contains unique elements from the sequence, in the same order as in this one.

compact

Sequence<T> compact()

Returns a new sequence that contains only the non-null elements from this sequence, in the same order as in this sequence.

join

java.lang.String join(java.lang.String delimiter)

Returns the sequence as a String, joined by the delimiter.