return

[Control Structures]

Description

Terminate a function and return a value from a function to the calling function, if desired.

Syntax

return;
return value;

Parameters

value: Allowed data types: any variable or constant type.

Example Code

A function to compare a sensor input to a threshold

int checkSensor() {
  if (analogRead(0) > 400) {
    return 1;
  }
  else {
    return 0;
  }
}

The return keyword is handy to test a section of code without having to “comment out” large sections of possibly buggy code.

void loop() {
  // brilliant code idea to test here

  return;

  // the rest of a dysfunctional sketch here
  // this code will never be executed
}

See also

• [Language] comments

Language Reference Home

The text of the 86Duino reference is a modification of the Arduino reference and is licensed under a Creative Commons Attribution-ShareAlike 3.0 License. Code samples in the reference are released into the public domain.