iterator_next function <BLOC/iterator.h>
The iterator_next function finds the next item in an iterable set. After this call, the iterator's position will be moved one ahead relative to where it currently is. The iterator object must have first had either iterator_first or iterator_last used to position it.
Syntax
void * iterator_next( Iterator *iter );
Parameters
iter
A pointer to the Iterator object controlling the iteration.
Return value
A reference pointer to the located object.