pxt-calliope/docs/reference/input/button-is-pressed.md

# Button Is Pressed

Get the state of an input button. The micro:bit has two input buttons: A and B.

```sig
input.buttonIsPressed(Button.A);
```

### Parameters

* name - [String](/reference/types/string); input button "A", "B", or "A+B" (both input buttons)

### Returns

* [Boolean](/reference/types/boolean) - `true` if pressed, `false` if not pressed

### Example

The following code uses an [if](/reference/logic/if) statement to run code, depending on whether or not the A button is pressed:

```blocks
basic.forever(() => {
    let pressed = input.buttonIsPressed(Button.A)
    if (pressed) {
        // this code runs if the A button is pressed
        basic.showNumber(1, 150)
    } else {
        // this code runs if the A button is *not* pressed
        basic.showNumber(0, 150)
    }
})
```

### Lessons

[zoomer](/lessons/zoomer)

### See also

[on button pressed](/reference/input/on-button-pressed), [if](/reference/logic/if), [forever](/reference/basic/forever)