Home Page | Language Reference (extended) | SD Reference | Libraries | Comparison | Changes
Reads the value from a specified digital pin, either HIGH or LOW.
digitalRead(pin)
pin: the number of the digital pin you want to read (int)
int ledPin = 13; // LED connected to digital pin 13int inPin = 7; // pushbutton connected to digital pin 7int val = 0; // variable to store the read valuevoid setup(){pinMode(ledPin, OUTPUT); // sets the digital pin 13 as outputpinMode(inPin, INPUT); // sets the digital pin 7 as input}void loop(){val = digitalRead(inPin); // read the input pindigitalWrite(ledPin, val); // sets the LED to the button's value}
Sets pin 13 to the same value as the pin 7, which is an input.
If the pin isn't connected to anything, digitalRead() can return either HIGH or LOW (and this can change randomly).
The analog input pins can be used as digital pins w/ numbers 14 (analog input 0) to 19 (analog input 5).
Corrections, suggestions, and new documentation should be posted to the Forum.
The text of the Arduino reference is licensed under a Creative Commons Attribution-ShareAlike 3.0 License. Code samples in the reference are released into the public domain.