intersperse

class iteration_utilities.intersperse(iterable, e)

Alternately yield an item from the iterable and e. Recipe based on the homonymous function in the more-itertools package ([Rfdca3682eca6-0]) but significantly modified.

Parameters
iterableiterable

The iterable to intersperse.

eany type

The value with which to intersperse the iterable.

Returns
interspersedgenerator

Interspersed iterable as generator.

Notes

This is similar to itertools.chain.from_iterable(zip(iterable, itertools.repeat(e))) except that intersperse does not yield e as last item.

References

Rfdca3682eca6-0

https://github.com/erikrose/more-itertools

Examples

A few simple examples:

>>> from iteration_utilities import intersperse
>>> list(intersperse([1,2,3], 0))
[1, 0, 2, 0, 3]

>>> list(intersperse('abc', 'x'))
['a', 'x', 'b', 'x', 'c']
__length_hint__()

Tries to estimate for the length of the instance (returns 0 if an estimation is not possible).

fillvalue

(any type) The interspersed fillvalue (readonly).

New in version 0.6.