File: do-while.xml

package info (click to toggle)
php-doc 20100521-2
  • links: PTS, VCS
  • area: main
  • in suites: squeeze, wheezy
  • size: 59,992 kB
  • ctags: 4,085
  • sloc: xml: 796,833; php: 21,338; cpp: 500; sh: 117; makefile: 58; awk: 28
file content (100 lines) | stat: -rw-r--r-- 2,907 bytes parent folder | download
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
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 289335 $ -->

<sect1 xml:id="control-structures.do.while" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title><literal>do-while</literal></title>
 <simpara>
  <literal>do-while</literal> loops are very similar to
  <literal>while</literal> loops, except the truth expression is
  checked at the end of each iteration instead of in the beginning.
  The main difference from regular <literal>while</literal> loops is
  that the first iteration of a <literal>do-while</literal> loop is
  guaranteed to run (the truth expression is only checked at the end
  of the iteration), whereas it may not necessarily run with a
  regular <literal>while</literal> loop (the truth expression is
  checked at the beginning of each iteration, if it evaluates to
  &false; right from the beginning, the loop
  execution would end immediately).
 </simpara>
 <para>
  There is just one syntax for <literal>do-while</literal> loops:

  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php
$i = 0;
do {
    echo $i;
} while ($i > 0);
?>
]]>
   </programlisting>
  </informalexample>
 </para>
 <simpara>
   The above loop would run one time exactly, since after the first
   iteration, when truth expression is checked, it evaluates to
   &false; (<varname>$i</varname> is not bigger than 0) and the loop
   execution ends.
 </simpara>
 <para>
  Advanced C users may be familiar with a different usage of the
  <literal>do-while</literal> loop, to allow stopping execution in
  the middle of code blocks, by encapsulating them with
  <literal>do-while</literal> (0), and using the <link
  linkend="control-structures.break"><literal>break</literal></link>
  statement.  The following code fragment demonstrates this:
  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php
do {
    if ($i < 5) {
        echo "i is not big enough";
        break;
    }
    $i *= $factor;
    if ($i < $minimum_limit) {
        break;
    }
   echo "i is ok";

    /* process i */

} while (0);
?>
]]>
   </programlisting>
  </informalexample>
 </para>
 <simpara>
  Don't worry if you don't understand this right away or at all.
  You can code scripts and even powerful scripts without using this
  'feature'.
  Since PHP 5.3.0, it is possible to use
  <link linkend="control-structures.goto"><literal>goto</literal></link>
  operator instead of this hack.
 </simpara>
</sect1>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->