org.grouplens.lenskit.collections

Interface FastIterable<E>

Type Parameters:

E - The type of value in the fast collection.

All Superinterfaces:

Iterable<E>

All Known Subinterfaces:

FastCollection<E>

All Known Implementing Classes:

CopyingFastCollection, PackedScoredIdList

Deprecated.

Fast iteration has gone away.

@Deprecated
public interface FastIterable<E>
extends Iterable<E>

Iterable supporting fast iteration.

A fast iterable is an iterable that may support fast iteration — iteration where the same object is returned each time, having been mutated to represent the next state. It can save greatly in object allocation overhead in some circumstances. Using a fast iterator is only possible if the looping code doesn't allow objects returned by the iterator to escape the loop (e.g. it doesn't save them away in other objects or something), but many loops only observe the object and then discard it before the next iteration. Those loops benefit from fast iterators.

Compatibility

Public

Method Summary

Modifier and Type	Method and Description
Iterator<E>	fastIterator() Deprecated. Fast iteration has gone away.

Methods inherited from interface java.lang.Iterable

forEach, iterator, spliterator

Method Detail

fastIterator

@Deprecated
Iterator<E> fastIterator()

Deprecated. Fast iteration has gone away.

Return a fast iterator. The iterator may not actually be fast; if the underlying structure does not support fast iteration, the iterator may return distinct objects every time. However, that is usually in cases where the underlying collection is storing distinct objects anyway so no overhead is introduced.

Returns:

An iterator that may not return distinct objects.