Imperative loop expressions documentation #1364
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
vyzo
reviewed
Sep 18, 2025
| 4. If `test` is false, the `command` expressions in the loop body are evaluated in order. | ||
| 5. Finally, the `step` expressions for each variable are evaluated. All `step` expressions are computed using the variable values from the previous iteration. After all steps are computed, the variables are simultaneously updated with their new values, and the loop proceeds to the next iteration (starting again at step 2). | ||
|
|
||
| ::: tip Examples: |
There was a problem hiding this comment.
no need for the trailing : (just Examples), the renderer will create a tip box.
| 4. If `test` is truthy, the `step` expressions are evaluated to compute the new values for the variables, and the loop continues from step 2. | ||
| 5. If `test` is false, the loop terminates. The `result` expressions are then evaluated, and the value of the last one is returned. | ||
|
|
||
| ::: tip Example: |
|
|
||
| This behavior means the loop body may be executed **zero or more times**. If the initial `test` is false, the body will never be executed. The `while` macro always returns a void value. | ||
|
|
||
| ::: tip Example: |
|
|
||
| Like [`while`](#while), the loop body may be executed **zero or more times**. The `until` macro always returns a void value. | ||
|
|
||
| ::: tip Example: |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR updates the documentation for the main imperative loop constructs provided by Gerbil: do, do-while, while, and until.
Each entry is organized into the following logical sections:
Note: English is not my native language (I’m a French speaker). The text was written with the help of Gemini and Google Translate.