diff options
| author |  Mark Griffiths <mark@thebespokepixel.com> | 2014-08-19 13:41:23 +0100 |
|---|---|---|
| committer | Mark Griffiths <mark@thebespokepixel.com> | 2014-09-03 14:43:26 +0100 |
| commit | 137abd0cfaa8959224f88a4ebe9584a51468cc88 (patch) | |
| tree | c396f760a1e309b5a837359e65c57c4555534d49 /doc_src/switch.txt | |
| parent | d7308fecbe573aad91fc6f1377c1ed2df735f6fd (diff) | |
Make line length, wrapping and spacing consistent
Diffstat (limited to 'doc_src/switch.txt')
| -rw-r--r-- | doc_src/switch.txt | 24 |
1 files changed, 6 insertions, 18 deletions
diff --git a/doc_src/switch.txt b/doc_src/switch.txt index 7245b63f..9bba2bb0 100644 --- a/doc_src/switch.txt +++ b/doc_src/switch.txt @@ -7,29 +7,18 @@ switch VALUE; [case [WILDCARD...]; [COMMANDS...]; ...] end \subsection switch-description Description -`switch` performs one of several blocks of commands, depending on whether -a specified value equals one of several wildcarded values. `case` is used -together with the `switch` statement in order to determine which block should -be executed. +`switch` performs one of several blocks of commands, depending on whether a specified value equals one of several wildcarded values. `case` is used together with the `switch` statement in order to determine which block should be executed. -Each `case` command is given one or more parameters. The first `case` -command with a parameter that matches the string specified in the -switch command will be evaluated. `case` parameters may contain -wildcards. These need to be escaped or quoted in order to avoid -regular wildcard expansion using filenames. +Each `case` command is given one or more parameters. The first `case` command with a parameter that matches the string specified in the switch command will be evaluated. `case` parameters may contain wildcards. These need to be escaped or quoted in order to avoid regular wildcard expansion using filenames. -Note that fish does not fall through on case statements. Only the -first matching case is executed. +Note that fish does not fall through on case statements. Only the first matching case is executed. + +Note that command substitutions in a case statement will be evaluated even if its body is not taken. All substitutions, including command substitutions, must be performed before the value can be compared against the parameter. -Note that command substitutions in a case statement will be -evaluated even if its body is not taken. All substitutions, including -command substitutions, must be performed before the value can be compared -against the parameter. \subsection switch-example Example -If the variable \$animal contains the name of an animal, the following -code would attempt to classify it: +If the variable \$animal contains the name of an animal, the following code would attempt to classify it: \fish switch $animal @@ -48,4 +37,3 @@ end If the above code was run with `$animal` set to `whale`, the output would be `mammal`. - |