Framework (A-Z)

Reference for Wiring version 1.0 Build 0100+ If you have a previous version, use the reference included with your software. If see any errors or have any comments, let us know.

Name

switch()

Examples
int num = 1;

switch (num) {
  case 0: 
    Serial.println("Zero"); // Does not execute
    break;
  case 1: 
    Serial.println("One");  // Prints "One"
    break;
}

char letter = 'N';

switch (letter) {
  case 'A': 
    Serial.println("Alpha"); // Does not execute
    break;
  case 'B': 
    Serial.println("Bravo"); // Does not execute
    break;
  default: // Default executes if the case labels
    Serial.println("None");  // don't match the switch parameter
    break;
}

// Removing a "break" enables testing
// for more than one value at once

char letter = 'b';

switch (letter) {
  case 'a':
  case 'A': 
    Serial.println("Alpha"); // Does not execute
    break;
  case 'b':
  case 'B': 
    Serial.println("Bravo"); // Prints "Bravo"
    break;
}
Description Works like an if else structure, but switch() is more convenient when you need to select between three or more alternatives. Program controls jumps to the case with the same value as the expression. All remaining statements in the switch are executed unless redirected by a break. Only primitive datatypes which can convert to an integer (byte, char, and int) may be used as the expression parameter. The default is optional.
Syntax
switch (expression)
{
  case label: 
     statements          
  case label:     // Optional
     statements   // Optional
  default:               // Optional
     statements   // Optional
}
Parameters
expression byte, char, or int
label byte, char, or int
statements one or more statements to be executed
Usage Application
Related case
default
break
if()
else
Updated on July 07, 2011 11:09:12pm PDT

Creative Commons License