aboutsummaryrefslogtreecommitdiffstats
path: root/docs/source/arduino/switchcase.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/source/arduino/switchcase.rst')
-rw-r--r--docs/source/arduino/switchcase.rst77
1 files changed, 77 insertions, 0 deletions
diff --git a/docs/source/arduino/switchcase.rst b/docs/source/arduino/switchcase.rst
new file mode 100644
index 0000000..28791eb
--- /dev/null
+++ b/docs/source/arduino/switchcase.rst
@@ -0,0 +1,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>`_
+
+