Source of: /manual/en/control-structures.continue.php
<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/language.control-structures.inc";
$setup = array (
'home' =>
array (
0 => 'index.php',
1 => 'PHP Manual',
),
'head' =>
array (
0 => 'UTF-8',
1 => 'en',
),
'this' =>
array (
0 => 'control-structures.continue.php',
1 => 'continue',
),
'up' =>
array (
0 => 'language.control-structures.php',
1 => 'Control Structures',
),
'prev' =>
array (
0 => 'control-structures.break.php',
1 => 'break',
),
'next' =>
array (
0 => 'control-structures.switch.php',
1 => 'switch',
),
);
$setup["toc"] = $TOC;
$setup["parents"] = $PARENTS;
manual_setup($setup);
manual_header();
?>
<div id="control-structures.continue" class="sect1">
<h2 class="title"><i>continue</i></h2>
<p class="simpara">
<i>continue</i> is used within looping structures to
skip the rest of the current loop iteration and continue execution
at the condition evaluation and then the beginning of the next iteration.
</p>
<blockquote><p><b class="note">Note</b>:
<span class="simpara">
Note that in PHP the
<a href="control-structures.switch.php" class="link">switch</a> statement is
considered a looping structure for the purposes of
<i>continue</i>.
</span>
</p></blockquote>
<p class="simpara">
<i>continue</i> accepts an optional numeric argument
which tells it how many levels of enclosing loops it should skip
to the end of.
</p>
<p class="para">
</p><div class="informalexample">
<div class="example-contents programlisting">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br /></span><span style="color: #007700">while (list(</span><span style="color: #0000BB">$key</span><span style="color: #007700">, </span><span style="color: #0000BB">$value</span><span style="color: #007700">) = </span><span style="color: #0000BB">each</span><span style="color: #007700">(</span><span style="color: #0000BB">$arr</span><span style="color: #007700">)) {<br /> if (!(</span><span style="color: #0000BB">$key </span><span style="color: #007700">% </span><span style="color: #0000BB">2</span><span style="color: #007700">)) { </span><span style="color: #FF8000">// skip odd members<br /> </span><span style="color: #007700">continue;<br /> }<br /> </span><span style="color: #0000BB">do_something_odd</span><span style="color: #007700">(</span><span style="color: #0000BB">$value</span><span style="color: #007700">);<br />}<br /><br /></span><span style="color: #0000BB">$i </span><span style="color: #007700">= </span><span style="color: #0000BB">0</span><span style="color: #007700">;<br />while (</span><span style="color: #0000BB">$i</span><span style="color: #007700">++ < </span><span style="color: #0000BB">5</span><span style="color: #007700">) {<br /> echo </span><span style="color: #DD0000">"Outer<br />\n"</span><span style="color: #007700">;<br /> while (</span><span style="color: #0000BB">1</span><span style="color: #007700">) {<br /> echo </span><span style="color: #DD0000">"&nbsp;&nbsp;Middle<br />\n"</span><span style="color: #007700">;<br /> while (</span><span style="color: #0000BB">1</span><span style="color: #007700">) {<br /> echo </span><span style="color: #DD0000">"&nbsp;&nbsp;Inner<br />\n"</span><span style="color: #007700">;<br /> continue </span><span style="color: #0000BB">3</span><span style="color: #007700">;<br /> }<br /> echo </span><span style="color: #DD0000">"This never gets output.<br />\n"</span><span style="color: #007700">;<br /> }<br /> echo </span><span style="color: #DD0000">"Neither does this.<br />\n"</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
</div><p>
</p>
<p class="para">
Omitting the semicolon after <i>continue</i> can lead to
confusion. Here's an example of what you shouldn't do.
</p>
<p class="para">
</p><div class="informalexample">
<div class="example-contents programlisting">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br /></span><span style="color: #007700">for (</span><span style="color: #0000BB">$i </span><span style="color: #007700">= </span><span style="color: #0000BB">0</span><span style="color: #007700">; </span><span style="color: #0000BB">$i </span><span style="color: #007700">< </span><span style="color: #0000BB">5</span><span style="color: #007700">; ++</span><span style="color: #0000BB">$i</span><span style="color: #007700">) {<br /> if (</span><span style="color: #0000BB">$i </span><span style="color: #007700">== </span><span style="color: #0000BB">2</span><span style="color: #007700">)<br /> continue<br /> print </span><span style="color: #DD0000">"</span><span style="color: #0000BB">$i</span><span style="color: #DD0000">\n"</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
<p class="para">
One can expect the result to be :
</p>
<div class="example-contents screen">
<div class="cdata"><pre>
0
1
3
4
</pre></div>
</div>
<p class="para">
but this script will output :
</p>
<div class="example-contents screen">
<div class="cdata"><pre>
2
</pre></div>
</div>
<p class="para">
because the return value of the <a href="function.print.php" class="function">print()</a>
call is <i>int(1)</i>, and it will look like the
optional numeric argument mentioned above.
</p>
</div><p>
</p>
</div><?php manual_footer(); ?>
