pxt-calliope/docs/reference/control/reset.md

39 lines
859 B
Markdown
Raw Normal View History

2016-03-26 00:47:20 +01:00
# Reset
Reset the @boardname@ and start the program again.
2016-11-02 01:44:37 +01:00
This function is like pressing the reset button on the back of the @boardname@.
2016-03-26 00:47:20 +01:00
```sig
control.reset()
```
## ~hint
2016-03-26 00:47:20 +01:00
**Simulator**
The **reset** function works only on a real @boardname@ and not in the simulator.
## ~
## Example
This program will count as high as you like when you press button `A`.
When you get tired of counting, press button `B` to reset the
2016-11-02 01:44:37 +01:00
@boardname@ and start the program over.
```blocks
let item = 0;
basic.showNumber(item);
input.onButtonEvent(Button.A, input.buttonEventValue(ButtonEvent.Down), () => {
item = item + 1;
basic.showNumber(item);
});
input.onButtonEvent(Button.B, input.buttonEventValue(ButtonEvent.Down), () => {
control.reset();
});
```
## See also
[clear screen](/reference/basic/clear-screen), [game over](/reference/game/game-over)