aboutsummaryrefslogtreecommitdiffstats
path: root/source/arduino/goto.rst
diff options
context:
space:
mode:
authorMarti Bolivar <mbolivar@mit.edu>2010-10-20 06:46:52 -0400
committerMarti Bolivar <mbolivar@mit.edu>2010-10-20 06:46:52 -0400
commit85c1c72db022bba891868afd3375e39dbe245701 (patch)
tree9d86a3db825667362a8c89a98a205586015aec94 /source/arduino/goto.rst
parentabcfcc62cc62dfc088d30d5a6b6c36d6c89f7b07 (diff)
downloadlibrambutan-85c1c72db022bba891868afd3375e39dbe245701.tar.gz
librambutan-85c1c72db022bba891868afd3375e39dbe245701.zip
initial check-in of arduino docs in RST format (converted using wget+pandoc)
Diffstat (limited to 'source/arduino/goto.rst')
-rw-r--r--source/arduino/goto.rst55
1 files changed, 55 insertions, 0 deletions
diff --git a/source/arduino/goto.rst b/source/arduino/goto.rst
new file mode 100644
index 0000000..1fcceb7
--- /dev/null
+++ b/source/arduino/goto.rst
@@ -0,0 +1,55 @@
+.. _arduino-goto:
+
+goto
+====
+
+Transfers program flow to a labeled point in the program
+
+
+
+Syntax
+------
+
+label:
+
+
+
+goto label; // sends program flow to the label
+
+
+
+Tip
+---
+
+The use of *goto* is discouraged in C programming, and some authors
+of C programming books claim that the *goto* statement is never
+necessary, but used judiciously, it can simplify certain programs.
+The reason that many programmers frown upon the use of *goto* is
+that with the unrestrained use of *goto* statements, it is easy to
+create a program with undefined program flow, which can never be
+debugged.
+
+
+
+With that said, there are instances where a goto statement can come
+in handy, and simplify coding. One of these situations is to break
+out of deeply nested *for* loops, or *if* logic blocks, on a
+certain condition.
+
+
+
+Example
+-------
+
+::
+
+ for(byte r = 0; r < 255; r++){
+ for(byte g = 255; g > -1; g--){
+ for(byte b = 0; b < 255; b++){
+ if (analogRead(0) > 250){ goto bailout;}
+ // more statements ...
+ }
+ }
+ }
+ bailout:
+