consume¶
-
iteration_utilities.
consume
(iterator, n)¶ Advance the iterator n-steps ahead. If n is
None
, consume entirely.- Parameters
- iteratoriterator
Any iterator from which to consume the items.
- n
int
or None Number of items to consume from the iterator. If
None
consume it entirely.
Examples
>>> from iteration_utilities import consume >>> g = (x**2 for x in range(10)) >>> consume(g, 2) >>> list(g) [4, 9, 16, 25, 36, 49, 64, 81]
>>> g = (x**2 for x in range(10)) >>> consume(g, None) >>> list(g) []