File: The-switch-Statement.html

package info (click to toggle)
octave 10.3.0-1
  • links: PTS, VCS
  • area: main
  • in suites:
  • size: 145,388 kB
  • sloc: cpp: 335,976; ansic: 82,241; fortran: 20,963; objc: 9,402; sh: 8,756; yacc: 4,392; lex: 4,333; perl: 1,544; java: 1,366; awk: 1,259; makefile: 659; xml: 192
file content (158 lines) | stat: -rw-r--r-- 6,634 bytes parent folder | download | duplicates (2)
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
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
<!DOCTYPE html>
<html>
<!-- Created by GNU Texinfo 7.1.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>The switch Statement (GNU Octave (version 10.3.0))</title>

<meta name="description" content="The switch Statement (GNU Octave (version 10.3.0))">
<meta name="keywords" content="The switch Statement (GNU Octave (version 10.3.0))">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta name="viewport" content="width=device-width,initial-scale=1">

<link href="index.html" rel="start" title="Top">
<link href="Concept-Index.html" rel="index" title="Concept Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Statements.html" rel="up" title="Statements">
<link href="The-while-Statement.html" rel="next" title="The while Statement">
<link href="The-if-Statement.html" rel="prev" title="The if Statement">
<style type="text/css">
<!--
a.copiable-link {visibility: hidden; text-decoration: none; line-height: 0em}
div.example {margin-left: 3.2em}
span:hover a.copiable-link {visibility: visible}
-->
</style>
<link rel="stylesheet" type="text/css" href="octave.css">


</head>

<body lang="en">
<div class="section-level-extent" id="The-switch-Statement">
<div class="nav-panel">
<p>
Next: <a href="The-while-Statement.html" accesskey="n" rel="next">The while Statement</a>, Previous: <a href="The-if-Statement.html" accesskey="p" rel="prev">The if Statement</a>, Up: <a href="Statements.html" accesskey="u" rel="up">Statements</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<h3 class="section" id="The-switch-Statement-1"><span>10.2 The switch Statement<a class="copiable-link" href="#The-switch-Statement-1"> &para;</a></span></h3>
<a class="index-entry-id" id="index-switch-statement"></a>
<a class="index-entry-id" id="index-case-statement"></a>
<a class="index-entry-id" id="index-otherwise-statement"></a>
<a class="index-entry-id" id="index-endswitch-statement"></a>

<p>It is very common to take different actions depending on the value of
one variable.  This is possible using the <code class="code">if</code> statement in the
following way
</p>
<div class="example">
<div class="group"><pre class="example-preformatted">if (X == 1)
  do_something ();
elseif (X == 2)
  do_something_else ();
else
  do_something_completely_different ();
endif
</pre></div></div>

<p>This kind of code can however be very cumbersome to both write and
maintain.  To overcome this problem Octave supports the <code class="code">switch</code>
statement.  Using this statement, the above example becomes
</p>
<div class="example">
<div class="group"><pre class="example-preformatted">switch (X)
  case 1
    do_something ();
  case 2
    do_something_else ();
  otherwise
    do_something_completely_different ();
endswitch
</pre></div></div>

<p>This code makes the repetitive structure of the problem more explicit,
making the code easier to read, and hence maintain.  Also, if the
variable <code class="code">X</code> should change its name, only one line would need
changing compared to one line per case when <code class="code">if</code> statements are
used.
</p>
<p>The general form of the <code class="code">switch</code> statement is
</p>
<div class="example">
<div class="group"><pre class="example-preformatted">switch (<var class="var">expression</var>)
  case <var class="var">label</var>
    <var class="var">command_list</var>
  case <var class="var">label</var>
    <var class="var">command_list</var>
  ...

  otherwise
    <var class="var">command_list</var>
endswitch
</pre></div></div>

<p>where <var class="var">label</var> can be any expression.  However, duplicate
<var class="var">label</var> values are not detected, and only the <var class="var">command_list</var>
corresponding to the first match will be executed.  For the
<code class="code">switch</code> statement to be meaningful at least one
<code class="code">case <var class="var">label</var> <var class="var">command_list</var></code> clause must be present,
while the <code class="code">otherwise <var class="var">command_list</var></code> clause is optional.
</p>
<p>If <var class="var">label</var> is a cell array the corresponding <var class="var">command_list</var>
is executed if <em class="emph">any</em> of the elements of the cell array match
<var class="var">expression</var>.  As an example, the following program will print
&lsquo;<samp class="samp">Variable is either 6 or 7</samp>&rsquo;.
</p>
<div class="example">
<div class="group"><pre class="example-preformatted">A = 7;
switch (A)
  case { 6, 7 }
    printf (&quot;variable is either 6 or 7\n&quot;);
  otherwise
    printf (&quot;variable is neither 6 nor 7\n&quot;);
endswitch
</pre></div></div>

<p>As with all other specific <code class="code">end</code> keywords, <code class="code">endswitch</code> may be
replaced by <code class="code">end</code>, but you can get better diagnostics if you use
the specific forms.
</p>

<p>One advantage of using the <code class="code">switch</code> statement compared to using
<code class="code">if</code> statements is that the <var class="var">label</var>s can be strings.  If an
<code class="code">if</code> statement is used it is <em class="emph">not</em> possible to write
</p>
<div class="example">
<pre class="example-preformatted">if (X == &quot;a string&quot;) # This is NOT valid
</pre></div>

<p>since a character-to-character comparison between <code class="code">X</code> and the
string will be made instead of evaluating if the strings are equal.
This special-case is handled by the <code class="code">switch</code> statement, and it
is possible to write programs that look like this
</p>
<div class="example">
<div class="group"><pre class="example-preformatted">switch (X)
  case &quot;a string&quot;
    do_something
  ...
endswitch
</pre></div></div>


<ul class="mini-toc">
<li><a href="Notes-for-the-C-Programmer.html" accesskey="1">Notes for the C Programmer</a></li>
</ul>
</div>
<hr>
<div class="nav-panel">
<p>
Next: <a href="The-while-Statement.html">The while Statement</a>, Previous: <a href="The-if-Statement.html">The if Statement</a>, Up: <a href="Statements.html">Statements</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>