digitalRead() - Digital I/O

Reads the value from a specified digital pin, either HIGH or LOW.
pin: the number of the digital pin you want to read (int)

Syntax

digitalRead(pin)

Example

int ledPin = 13; // LED connected to digital pin 13
int inPin = 7;   // pushbutton connected to digital pin 7
int val = 0;     // variable to store the read value

void setup()
{
  pinMode(ledPin, OUTPUT);      // sets the digital pin 13 as output
  pinMode(inPin, INPUT);      // sets the digital pin 7 as input
}

void loop()
{
  val = digitalRead(inPin);   // read the input pin
  digitalWrite(ledPin, val);    // sets the LED to the button's value
}

Output / Return Value

HIGH or LOW

Limitations

Alternatives / See Also

Reference

https://www.arduino.cc/en/Reference/DigitalRead