aboutsummaryrefslogtreecommitdiffstats
path: root/docs/source/arduino/switchcase.rst
blob: 28791eb40f1f7a002d8e8402d153e28d5693fb35 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
.. _arduino-switchcase:

switch / case statements
========================

Like **if** statements, **switch...case** controls the flow of
programs by allowing programmers to specify different code that
should be executed in various conditions. In particular, a switch
statement compares the value of a variable to the values specified
in case statements. When a case statement is found whose value
matches that of the variable, the code in that case statement is
run.



The **break** keyword exits the switch statement, and is typically
used at the end of each case. Without a break statement, the switch
statement will continue executing the following expressions
("falling-through") until a break, or the end of the switch
statement is reached.



Example
~~~~~~~

::

      switch (var) {
        case 1:
          //do something when var equals 1
          break;
        case 2:
          //do something when var equals 2
          break;
        default: 
          // if nothing else matches, do the default
          // default is optional
      }



Syntax
~~~~~~

::

    switch (var) {
      case label:
        // statements
        break;
      case label:
        // statements
        break;
      default: 
        // statements
    }



Parameters
~~~~~~~~~~

var: the variable whose value to compare to the various cases



label: a value to compare the variable to



See also:
---------

`if...else <http://arduino.cc/en/Reference/Else>`_