aboutsummaryrefslogtreecommitdiffhomepage
path: root/doc_src/switch.txt
diff options
context:
space:
mode:
authorGravatar axel <axel@liljencrantz.se>2005-09-20 23:31:55 +1000
committerGravatar axel <axel@liljencrantz.se>2005-09-20 23:31:55 +1000
commit7ddecde54372c25fcf526e2d24807c5dac9800aa (patch)
tree1bff6e0ccd096836adb74529d53a6debcf45375b /doc_src/switch.txt
parent149594f974350bb364a76c73b91b1d5ffddaa1fa (diff)
Add subdirectories
darcs-hash:20050920133155-ac50b-9a14c6c664dd03afbe8e15e7c7998fcfb5c3c750.gz
Diffstat (limited to 'doc_src/switch.txt')
-rw-r--r--doc_src/switch.txt37
1 files changed, 37 insertions, 0 deletions
diff --git a/doc_src/switch.txt b/doc_src/switch.txt
new file mode 100644
index 00000000..06a32450
--- /dev/null
+++ b/doc_src/switch.txt
@@ -0,0 +1,37 @@
+
+\section switch switch - conditionally execute a block of commands
+
+\subsection switch-synopsis Synopsis
+ <tt>switch VALUE; [case [WILDCARD...]; [COMMANDS...];...] end</tt>
+
+\subsection switch-description Description
+
+The \c switch statement is used to perform one of several blocks of
+commands depending on whether a specified value equals one of several
+wildcarded values.
+
+\subsection switch-example Example
+
+If the variable \$animal contins the name of an animal, the
+following code would attempt to classify it:
+
+<p>
+<pre>
+switch $animal
+ case cat
+ echo evil
+ case wolf dog human moose dolphin whale
+ echo mammal
+ case duck goose albatros
+ echo bird
+ case shark trout stingray
+ echo fish
+end
+</pre>
+</p>
+<p>
+
+If the above code was run with \$animal set to \c whale, the output
+would be \c mammal.
+
+</p>