murex rocks

Welcome

About

Install

Change Log

Blog

Technical Docs

Language Tour

Interactive Shell

Rosetta Stone

User Guide

Open Source

Discuss

Contribute

Source Code

Search Site

while

Loop until condition false

Description

while loops until loops until condition is false.

Normally the conditional and executed code block are 2 separate parameters however you can call while with just 1 parameter where the code block acts as both the conditional and the code to be ran.

Usage

Until true

while { condition } { code-block } -> <stdout>

while { code-block } -> <stdout>

Until false

!while { condition } { code-block } -> <stdout>

!while { code-block } -> <stdout>

Examples

With conditional block

while $i is less then 5

» i=0; while { $i<5 } { i=$i+1; out $i }
1
2
3
4
5

Without conditional block

» i=0; while { i=$i+1; $i<5; out }
true
true
true
true
false

Until false

while $i is NOT greater than or equal to 5

» i=0; !while { $i >= 5 } { $i += 1; out $i }
1
2
3
4
5

Detail

Meta values

Meta values are a JSON object stored as the variable $.. The meta variable will get overwritten by any other block which invokes meta values. So if you wish to persist meta values across blocks you will need to reassign $., eg

%[1..3] -> foreach {
    meta_parent = $.
    %[7..9] -> foreach {
        out "$(meta_parent.i): $.i"
    }
}

The following meta values are defined:

• i: iteration number

Synonyms

• while
• !while

See Also

• err: Print a line to the stderr
• for: A more familiar iteration loop to existing developers
• foreach: Iterate through an array
• formap: Iterate through a map or other collection of data
• global: Define a global variable and set it’s value
• let: Evaluate a mathematical function and assign to variable (deprecated)
• out: Print a string to the stdout with a trailing new line character
• set: Define a local variable and set it’s value

---

This document was generated from builtins/core/structs/while_doc.yaml.