ca.uhn.cache.util
Interface IMutableMergeableIterator

All Superinterfaces:

IMutableIterator, java.util.Iterator

All Known Implementing Classes:

MutableMergeableIterator

public interface IMutableMergeableIterator

extends IMutableIterator

An extension of IMutableIterator with a convenience method for merging multiple iterators.

Version:

$Revision: 1.1 $ updated on $Date: 2005/01/26 00:25:50 $ by $Author: bryan_tripp $

Author:

Bryan Tripp

Method Summary

void	merge(java.util.Iterator theIterator) Incorporates the contents of the given iterator into this one.

Methods inherited from interface ca.uhn.cache.util.IMutableIterator

add, close, declareException, freeze

Methods inherited from interface java.util.Iterator

hasNext, next, remove

Method Detail

merge

public void merge(java.util.Iterator theIterator)

Incorporates the contents of the given iterator into this one. No guarantees are made as to the resulting ordering of elements. If the given iterator is an IMutableIterator, and close() is called some time in the future, then close() will be called on the merged IMutableIterator as well.

Parameters:

theIterator - another Iterator to combine with this one