Package edu.rice.cs.plt.iter

A collection of implementations of Iterable and Iterator.

See:
Description

Interface Summary

OptimizedLastIterable<T>	An iterable that supports a last operation that executes more quickly than traversing the entire contents of the list.
SizedIterable<T>	Allows size calculations on Iterables.

Class Summary

AbstractIterable<T>	A parent class for iterables that implements toString, hashCode, and equals.
BinaryMappedIterable<T1,T2,R>	An Iterable containing the results of some binary operation on two input lists (assumed to always have the same size).
BinaryMappedIterator<T1,T2,R>	An Iterator that applies a provided mapping lambda to each corresponding member of two source iterators.
CartesianIterable<T1,T2,R>	Enumerates the elements of a cartesian (or cross) product.
CartesianIterator<T1,T2,R>	Enumerates the elements of a cartesian (or cross) product.
CollapsedIterable<T>	Collapses a list of lists into a single list.
CollapsedIterator<T>	An iterator over an arbitrary number of iterators.
ComposedIterable<T>	Defines an iterable by composing two other iterables (or a value with an iterable).
ComposedIterator<T>	Defines an iterator by composing two other iterators.
DiagonalCartesianIterable<T1,T2,R>	Enumerates the elements of a cartesian (or cross) product in diagonal order.
DiagonalCartesianIterator<T1,T2,R>	Enumerates the elements of a cartesian (or cross) product in diagonal order.
EmptyIterable<T>	A 0-length iterable
EmptyIterator<T>	An Iterator over a 0-length list.
FilteredIterable<T>	An Iterable containing all the values in the provided Iterable for which the provided Predicate holds.
FilteredIterator<T>	An Iterator that only returns the values in another Iterator (i) for which some predicate (p) holds.
FiniteSequenceIterable<T>	An iterable representing a finite sequence.
FiniteSequenceIterator<T>	An iterator over a finite sequence of values, defined by an initial value, a successor function, and a size.
ImmutableIterable<T>	Wraps an iterable in an immutable interface, thus allowing internal data structures to be treated by clients as iterables without allowing access (via casting) to their mutating methods.
ImmutableIterator<T>	Wraps an iterator in an immutable interface, preventing modifications to underlying data structures via ReadOnlyIterator.remove().
IndexedIterator<T>	An iterator for index-based data structures.
IterUtil	A collection of static methods operating on iterables and iterators.
IterUtilTest	Tests for the IterUtil methods
MappedIterable<S,T>	An Iterable containing all the values in the provided Iterable after applying some specified transformation.
MappedIterator<S,T>	An Iterator that applies a provided mapping lambda to each member of a source iterator.
MutableSingletonIterator<T>	An Iterator over a 1-length list that supports removal by delegating to the given listener.
NoDuplicatesIterator<T>	An Iterator that returns each value only once.
NoDuplicatesIteratorTest
PermutationIterable<T>	An enumeration of all permutations of the given list.
PermutationIterator<T>	Enumerates all permutations of the given list.
ReadOnceIterable<T>	An iterable that simply wraps an Iterator.
ReadOnlyIterator<T>	An abstract implementation of Iterator that implements Iterator.remove() by throwing an UnsupportedOperationException.
RemoveNotificationIterator<T>	An iterator that notifies a callback whenever an element is removed.
SequenceIterable<T>	An iterable representing an infinite sequence.
SequenceIterator<T>	An iterator over an infinite sequence of values, defined by an initial value and a successor function.
SingletonIterable<T>	An iterable wrapping a single value
SingletonIterator<T>	An Iterator over a 1-length list
SkipFirstIterable<T>	Contains all but the first element of a wrapped iterable.
SkipLastIterable<T>	Contains all but the last element of a wrapped iterable.
SkipLastIterator<T>	An iterator that skips the last element of a nested iterator.
SnapshotIterable<T>	Creates an iterable based on the result of immediately traversing some other iterable (assumed to be finite); generated iterators will traverse those same values in the same order.
TruncatedIterable<T>	Contains, for some value size, the first size elements of a nested iterable.
TruncatedIterator<T>	Truncates a given iterator to have at most size elements.

Package edu.rice.cs.plt.iter Description

A collection of implementations of Iterable and Iterator. These classes provide a lightweight alternative to the Collection classes. The Iterables are generally immutable (although many can contain mutable collections), and define little more than the iterator and size methods (as implementations of SizedIterable). They allow easy composition (see ComposedIterable), mapping with lambdas (see MappedIterable, etc.), and interaction with tuples (see IterUtil).