From: Ned Batchelder Date: Fri, 27 Sep 2024 10:17:25 +0000 (-0400) Subject: Docs: for for/else clarify that return or raise also skip the else (#124591) X-Git-Tag: v3.14.0a1~292 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=5329d1b74a86b3a22ff36f7976bfe720ee06d10d;p=thirdparty%2FPython%2Fcpython.git Docs: for for/else clarify that return or raise also skip the else (#124591) Co-authored-by: Jelle Zijlstra --- diff --git a/Doc/tutorial/controlflow.rst b/Doc/tutorial/controlflow.rst index c97c65f7a398..fd765e58ff24 100644 --- a/Doc/tutorial/controlflow.rst +++ b/Doc/tutorial/controlflow.rst @@ -209,8 +209,10 @@ after the loop finishes its final iteration, that is, if no break occurred. In a :keyword:`while` loop, it's executed after the loop's condition becomes false. -In either kind of loop, the :keyword:`!else` clause is **not** executed -if the loop was terminated by a :keyword:`break`. +In either kind of loop, the :keyword:`!else` clause is **not** executed if the +loop was terminated by a :keyword:`break`. Of course, other ways of ending the +loop early, such as a :keyword:`return` or a raised exception, will also skip +execution of the :keyword:`else` clause. This is exemplified in the following :keyword:`!for` loop, which searches for prime numbers::