Skip to content

Commit ff14b62

Browse files
committed
Document unpacking in generator expressions
1 parent 9def455 commit ff14b62

1 file changed

Lines changed: 11 additions & 0 deletions

File tree

‎Doc/reference/expressions.rst‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -967,6 +967,17 @@ For example::
967967
>>> iterator
968968
<generator object <genexpr> at ...>
969969

970+
Like list comprehensions, generator expressions can unpack the iterable
971+
produced by their leading expression by prefixing it with ``*``.
972+
The elements of each iterable are yielded in order::
973+
974+
>>> flattened = (*values for values in [(1, 2), (3, 4)])
975+
>>> list(flattened)
976+
[1, 2, 3, 4]
977+
978+
.. versionadded:: 3.15
979+
Unpacking in generator expressions was introduced in :pep:`798`.
980+
970981
At runtime, a generator expression evaluates to a :term:`generator iterator`
971982
which yields the same values as the corresponding list comprehension::
972983

0 commit comments

Comments
 (0)