de.lmu.ifi.dbs.elki.database.ids

Interface DBIDIter

All Superinterfaces:

DBIDRef, Iter

All Known Subinterfaces:

DBIDArrayIter, DBIDArrayMIter, DBIDMIter, DoubleDBIDListIter, DoubleDBIDListMIter, DoubleIntegerDBIDListIter, DoubleIntegerDBIDListMIter, IntegerDBIDArrayIter, IntegerDBIDArrayMIter, IntegerDBIDIter, IntegerDBIDMIter

All Known Implementing Classes:

ArrayModifiableIntegerDBIDs.Itr, ArrayModifiableIntegerDBIDs.Slice.SliceItr, ArrayStaticIntegerDBIDs.Itr, ArrayStaticIntegerDBIDs.Slice.SliceItr, DoubleIntegerDBIDArrayList.Itr, DoubleIntegerDBIDKNNHeap.UnorderedIter, DoubleIntegerDBIDSubList.Itr, EmptyDBIDs.EmptyDBIDIterator, FastutilIntOpenHashSetModifiableDBIDs.Itr, IntegerDBID.Itr, IntegerDBIDKNNSubList.Itr, IntegerDBIDPair.Itr, IntegerDBIDPair.Slice.SliceItr, IntegerDBIDRange.Itr, IntegerDBIDVar.Itr, UnmodifiableIntegerArrayDBIDs.Itr, UnmodifiableIntegerDBIDs.UnmodifiableDBIDIter

public interface DBIDIter
extends DBIDRef, Iter

Iterator for DBIDs.

Important note: this iterator has a significantly different syntax and semantics than the Java iterators. It is much more aligned with C than with Java, but at the same time, the syntax is much more compatible with for loops.

Usage example:

  
 for (DBIDIter iter = ids.iter(); iter.valid(); iter.advance()) {
   Object o = relation.get(iter); // Many interfaces allow direct use
   DBID id = DBIDUtil.deref(iter); // Materialize only if you need to!
 }
 
 

We list some fundamental differences.

• iter.valid() refers to the current element, Iterator.next() to the next.
• iter.advance() does not return an element. Use get... to access it.
• DBIDIter.get... do not advance the iterator.

Since:

0.5.0

Author:

Erich Schubert

Method Summary

Modifier and Type	Method and Description
DBIDIter	advance() Moves the iterator forward to the next entry.

Methods inherited from interface de.lmu.ifi.dbs.elki.database.ids.DBIDRef

equals, hashCode, internalGetIndex

Methods inherited from interface de.lmu.ifi.dbs.elki.utilities.datastructures.iterator.Iter

valid

Method Detail

advance

DBIDIter advance()

Description copied from interface: Iter

Moves the iterator forward to the next entry.

Specified by:

advance in interface Iter

Returns:

The iterator itself.