pxt-calliope/docs/blocks/loops/while.md
Peli de Halleux 92b60a251d On start support (#324)
* annotating APIs to support onstart

* missed file

* updated templates

* adding new lines in main.ts

* fixing docs

* removing onstart

* updated docs

* updated various docs

* more docs

* adding upgrade policies for blocks

* updated pxt reference

* placing on start under "basic"
2016-12-19 14:09:35 -08:00

949 B

While

Repeat code while a Boolean condition is true.

while(true) {
}

The while loop has a condition that evaluates to a Boolean value. After the do keyword, add the code that you want to run while the condition is true. The while loop concludes with end while.

The condition is tested before any code runs. Which means that if the condition is false, the code inside the loop doesn't execute.

Example: diagonal line

The following example uses a while loop to make a diagonal line on the LED screen (points 0, 0, 1, 1, 2, 2, 3, 3, 4, 4).

input.onButtonPressed(Button.A, () => {
    let index = 4;
    while(index >= 0) {
        led.plot(index, index);
        index--;
    }
})

See also

on button pressed, for, if, forever