one¶
-
iteration_utilities.
one
(iterable, /)¶ Return the first value in the iterable and expects it only contains one element.
- Parameters
- iterableiterable
The iterable from which to get the one item.
- Returns
- oneany type
The first value.
- Raises
- ValueError :
If the iterable contains no items or more than one item.
Examples
Some basic examples:
>>> from iteration_utilities import one >>> one([0]) 0 >>> one('b') 'b'
Warning
one()
will access the first two values of the iterable so it should only be used if the iterable must only contain one item!