pxt-calliope/docs/reference/input/pin-is-pressed.md
Sam El-Husseini e3975e65e5 pxt-microbit Accessibility PR ()
* Accessibility changes
2017-09-07 13:42:08 -07:00

1.3 KiB

Pin Is Pressed

Find whether the pin you say is pressed or not pressed.

If you hold the GND pin with one hand and touch pin 0, 1, or 2 with the other, a very small (safe) amount of electricity will flow through your body and back into the @boardname@. This is called completing a circuit. It's like you're a big wire!

input.pinIsPressed(TouchPin.P0);

~hint

This function works best when the @boardname@ is using batteries for power, instead of the USB cable.

~

Parameters

  • a string that holds the pin name (P0, P1, or P2)

returns

  • a boolean that means whether the pin you say is pressed (true or false)

Example

This program shows 1 if P0 is pressed, and 0 if P0 is not pressed:

basic.forever(() => {
    if (input.pinIsPressed(TouchPin.P0)) {
        basic.showNumber(1, 150)
    } else {
        basic.showNumber(0, 150)
    }
})

See also

@boardname@ pins, on pin pressed, analog read pin, analog write pin, digital read pin, digital write pin