successive¶
-
class
iteration_utilities.
successive
(iterable, times=2)¶ Like the recipe for pairwise but allows to get an arbitrary number of successive elements.
- Parameters
- iterableiterable
Get the successive elements from this iterable.
- times
int
, optional The number of successive elements. Default is
2
.
- Returns
- successive_elementsgenerator
The successive elements as generator. Each element of the generator is a tuple containing times successive elements.
Examples
Each item of the iterable is returned as
tuple
with times successive items:>>> from iteration_utilities import successive >>> list(successive(range(5))) [(0, 1), (1, 2), (2, 3), (3, 4)]
Varying the times can give you also 3 successive elements:
>>> list(successive(range(5), times=3)) [(0, 1, 2), (1, 2, 3), (2, 3, 4)] >>> list(successive('Hello!', times=2)) [('H', 'e'), ('e', 'l'), ('l', 'l'), ('l', 'o'), ('o', '!')]
-
__length_hint__
()¶ Tries to estimate for the length of the instance (returns
0
if an estimation is not possible).