iterator/buffered_continuation_iterator

class BufferedContinuationIterator < Object

A BufferedContinuationIterator works just like a ContinuationIterator, but it is buffered (it grabs many elements at once when it iterates), so it is faster. It does not grab the whole list at once, like a CollectIterator, so it does not eat too much memory.

Public Methods

buffer_size

initialize(container, method=:each, buffer_size=nil)

Create a new ContinuationIterator. Once created, elem() will return the first element. Advancing the iterator will move elem() to the next element.

container	the container to be iterated.
method	the iterator method to use.
buffer_size	the size of the buffer to use. If nil (the default), then the log base 2 of container.size is used.

advance

Advance an iterator to the next element. Returns nil if there are no more elements.

TODO: If an exception is thrown, then the iterator is left in an indeterminate state.

Returns: the next element.

elem

Return the current element

Determine if we have reached the end

Requires