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

1.4 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)

Pin presses in action

See how the @boardname@ detects a press at a pin or on something connected to a pin in this video:

https://www.youtube.com/watch?v=GEpZrvbsO7o

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)
    } else {
        basic.showNumber(0)
    }
})

See also

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