digitalRead() — Maple v0.0.9 Documentation

### Navigation

- next
- previous |
- LeafLabs |
- Docs Home |
- Index »
- Complete Language Index »

# digitalRead()

Reads the value from a specified digital pin, either HIGH or LOW.

## Library Documentation

uint32 digitalRead(uint8 pin)

  Read a digital value from a pin.

  The pin must have its mode set to one of INPUT, INPUT_PULLUP, and INPUT_PULLDOWN.

  Parameters

  - `pin` -

    Pin to read from. One of: 0-38 (pin numbers as labeled on silkscreen), or D0-D38 (symbols for same)

  Return
    LOW or HIGH.
  See
    pinMode()

## Example

The following example turns the LED on when the button is pressed:

    int ledPin = 13;     // LED connected to Maple pin 13
    int buttonPin = 38;  // BUT connected to Maple pin 38

    void setup() {
      pinMode(ledPin, OUTPUT);
      pinMode(buttonPin, INPUT);
    }

    void loop() {
      int val = digitalRead(buttonPin);   // reads the input pin
      digitalWrite(ledPin, val);
    }

## Note

If the pin isn’t connected to anything, `digitalRead()` can return either HIGH or LOW (and this can change in a way that seems random).

## Arduino Compatibility

The Maple version of `digitalRead()` is compatible with Arduino.

## See Also

- pinMode
- digitalWrite

License and Attribution

This documentation page was adapted from the Arduino Reference Documentation, which is released under a Creative Commons Attribution-ShareAlike 3.0 License.

### Navigation

- next
- previous |
- LeafLabs |
- Docs Home |
- Index »
- Complete Language Index »