advance

inline fun <T> Iterator<T>.advance(numberToAdvance: Int): Int(source)

Calls next on this, either numberToAdvance times or until hasNext returns false, whichever comes first.

the number of elements the iterator was advanced