Document: I can guess "advances the iterator and returns the newly-selected item, or NULL if finished" but it's still worth saying.