Reads the value from a specified digital pin, either HIGH or LOW.
Read a digital value from a pin.
The pin must have its mode set to one of INPUT, INPUT_PULLUP, and INPUT_PULLDOWN.
Parameters: |
|
---|---|
Return: | LOW or HIGH. |
See: |
If the pin isn’t connected to anything, digitalRead() can return either HIGH or LOW (and this will change in a way that seems random).
The following example turns the LED on or off when the button is pressed:
void setup() {
pinMode(BOARD_LED_PIN, OUTPUT);
pinMode(BOARD_BUTTON_PIN, INPUT);
}
void loop() {
int val = digitalRead(BOARD_BUTTON_PIN); // reads the input pin
togglePin(BOARD_LED_PIN);
}
The Maple version of digitalRead() is compatible with Arduino.
License and Attribution
Portions of this page were adapted from the Arduino Reference Documentation, which is released under a Creative Commons Attribution-ShareAlike 3.0 License.