Thanks to visit codestin.com
Credit goes to github.com

Skip to content

bpo-46033: Clarify for-statement execution #30025

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 7 commits into from
Apr 3, 2022
Merged

bpo-46033: Clarify for-statement execution #30025

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
2e92aad
Remove duplicated sentence from for statement docs
michcio1234 Dec 10, 2021
8b5eb99
Add news entry
michcio1234 Jan 3, 2022
a83fbcb
Merge branch 'main' into fix-issue-46033-for-statement-docs
terryjreedy Apr 2, 2022
8c6856b
Update 2022-01-03-18-50-39.bpo-46033.7WeF0f.rst
terryjreedy Apr 2, 2022
46037d1
Update Doc/reference/compound_stmts.rst
terryjreedy Apr 2, 2022
0fd36f8
Update Doc/reference/compound_stmts.rst
terryjreedy Apr 2, 2022
e2742b0
Incorporate remaining suggestions.
terryjreedy Apr 3, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 8 additions & 11 deletions Doc/reference/compound_stmts.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -157,17 +157,14 @@ The :keyword:`for` statement is used to iterate over the elements of a sequence
for_stmt: "for" `target_list` "in" `starred_list` ":" `suite`
: ["else" ":" `suite`]

The expression list is evaluated once; it should yield an iterable object. An
iterator is created for the result of the ``starred_list``. The expression
list can contain starred elements (``*x, *y``) that will be unpacked in the
final iterator (as when constructing a ``tuple`` or ``list`` literal). The
suite is then executed once for each item provided by the iterator, in the
order returned by the iterator. Each item in turn is assigned to the target
list using the standard rules for assignments (see :ref:`assignment`), and then
the suite is executed. When the items are exhausted (which is immediately when
the sequence is empty or an iterator raises a :exc:`StopIteration` exception),
the suite in the :keyword:`!else` clause, if present, is executed, and the loop
terminates.
The ``starred_list`` expression is evaluated once; it should yield an
:term:`iterable` object. An :term:`iterator` is created for that iterable.
The first item provided
by the iterator is then assigned to the target list using the standard
rules for assignments (see :ref:`assignment`), and the suite is executed. This
repeats for each item provided by the iterator. When the iterator is exhausted,
the suite in the :keyword:`!else` clause,
if present, is executed, and the loop terminates.

.. index::
statement: break
Expand Down
1 change: 1 addition & 0 deletions Misc/NEWS.d/next/Documentation/2022-01-03-18-50-39.bpo-46033.7WeF0f.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
Clarify ``for`` statement execution in its doc.