cvs: phpdoc-de /language control-structures.xml
| From: | Friedhelm Betz | Date: | Sat, 17 Jan 2004 20:31:02 +0000 |
| Subject: | cvs: phpdoc-de /language control-structures.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-1061@lists.php.net to get a copy of this message | ||
betz Sat Jan 17 15:31:02 2004 EDT
Modified files:
/phpdoc-de/language control-structures.xml
Log:
sync to en
Index: phpdoc-de/language/control-structures.xml diff -u phpdoc-de/language/control-structures.xml:1.34 phpdoc-de/language/control-structures.xml:1.35 --- phpdoc-de/language/control-structures.xml:1.34 Sat Aug 16 09:09:07 2003 +++ phpdoc-de/language/control-structures.xml Sat Jan 17 15:31:02 2004 @@ -1,30 +1,28 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.34 $ --> -<!-- EN-Revision: 1.66 Maintainer: betz Status: ready --> +<!-- $Revision: 1.35 $ --> +<!-- EN-Revision: 1.85 Maintainer: betz Status: ready --> <!-- CREDITS: tzwenny --> <chapter id="control-structures"> <title>Kontroll-Strukturen</title> <simpara> - Jedes PHP-Skript besteht aus einer Reihe von Anweisungen. Eine - Anweisung kann aus einem Funktionsaufruf, einer Schleife, einer - bedingten Anweisung oder einem Befehl, der nichts macht (eine - leere Anweisung), bestehen. Jede Anweisung endet gewöhnlich mit - einem Semikolon. Darüber hinaus können Anweisungen zu einer - Anweisungsgruppe zusammengefasst werden, welche durch geschweifte - Klammern begrenzt wird. Eine Anweisungsgruppe ist auch eine - Anweisung. Die unterschiedlichen Arten von Anweisungen werden in - diesem Abschnitt erläutert. + Jedes PHP-Skript besteht aus einer Reihe von Anweisungen. Eine Anweisung + kann eine Zuweisung, ein Funktionsaufruf, eine Schleife, eine bedingte + Anweisung oder ein Befehl sein, der nichts macht (eine leere Anweisung). + Jede Anweisung endet gewöhnlich mit einem Semikolon. Darüber hinaus können Anweisungen zu einer + Anweisungsgruppe zusammengefasst werden, welche durch geschweifte Klammern + begrenzt wird. Eine Anweisungsgruppe selbst ist auch wieder eine Anweisung. + Die unterschiedlichen Arten von Anweisungen werden in diesem Kapitel + erläutert. </simpara> <sect1 id="control-structures.if"> <title><literal>if</literal></title> <para> - Das <literal>if</literal>-Konstrukt ist eine der wichtigsten - Möglichkeiten vieler Programmier-Sprachen, PHP eingeschlossen. - Es erlaubt die bedingte Ausführung von Programmteilen. PHP - kennt eine <literal>if</literal>-Struktur, die ähnlich der - Programmiersprache C ist: + Das <literal>if</literal>-Konstrukt ist eine der wichtigsten Möglichkeiten + vieler Programmier-Sprachen, PHP eingeschlossen. Es erlaubt die bedingte + Ausführung von Programmteilen. PHP kennt eine <literal>if</literal> + -Struktur, die ähnlich wie in der Programmiersprache C implementiert ist: <informalexample> <programlisting> <![CDATA[ @@ -36,23 +34,26 @@ </para> <simpara> Wie im Abschnitt über - <link linkend="language.expressions">Ausdrücke</link> beschrieben, wird - <replaceable>ausdr</replaceable> auf seinen boolschen Wertinhalt + <link linkend="language.expressions">Ausdrücke</link> beschrieben, + wird <replaceable>ausdr</replaceable> auf seinen boolschen Wertinhalt ausgewertet. Wenn <replaceable>ausdr</replaceable> als &true; ausgewertet - wird, führt PHP die <replaceable>Anweisung</replaceable> aus, falls die - Auswertung &false; ergibt, wird sie übergangen. Mehr Informationen welche - Werte als &false; ausgewertet werden finden Sie im Abschnitt + wird, führt PHP die <replaceable>Anweisung</replaceable> aus. Falls die + Auswertung &false; ergibt, wird die <replaceable>Anweisung</replaceable> + übergangen. Mehr Informationen drüber welche Werte als &false; ausgewertet + werden finden Sie im Abschnitt <link linkend="language.types.boolean.casting">'Umwandlung nach boolean'</link>. </simpara> <para> Das folgende Beispiel wird <computeroutput>a ist größer als b - </computeroutput>anzeigen, wenn <replaceable>$a</replaceable> - größer als <replaceable>$b</replaceable> ist: + </computeroutput>anzeigen, wenn <replaceable>$a</replaceable> größer als + <replaceable>$b</replaceable> ist: <informalexample> <programlisting role="php"> <![CDATA[ +<?php if ($a > $b) - print "a ist größer als b"; + echo "a ist größer als b"; +?> ]]> </programlisting> </informalexample> @@ -62,25 +63,27 @@ Anweisung wollen. Selbstverständlich ist es nicht erforderlich, jede Anweisung mit einer <literal>if</literal>-Bedingung zu versehen. Statt dessen können Sie mehrere Anweisungen in Gruppen - zusammenfassen. Z.B. wird der folgende Programm-Code + zusammenfassen. Der folgende Programm-Code wird zum Beispiel <computeroutput>a ist größer als b</computeroutput> anzeigen, wenn <replaceable>$a</replaceable> größer als - <replaceable>$b</replaceable> ist. Danach wird der Wert von + <replaceable>$b</replaceable> ist und danach wird der Wert von <replaceable>$a</replaceable> in <replaceable>$b</replaceable> gespeichert: <informalexample> <programlisting role="php"> <![CDATA[ +<?php if ($a > $b) { print "a ist größer als b"; $b = $a; } +?> ]]> </programlisting> </informalexample> </para> <simpara> - <literal>If</literal>-Anweisungen können beliebig oft innerhalb anderer + <literal>if</literal>-Anweisungen können beliebig oft innerhalb anderer <literal>if</literal>-Anweisungen definiert werden. Das ermöglicht ihnen völlige Flexibilität bei der bedingten Ausführung verschiedenster Programmteile. @@ -90,25 +93,26 @@ <sect1 id="control-structures.else"> <title><literal>else</literal></title> <para> - Häufig ist es erforderlich, eine Anweisung auszuführen, wenn eine + Häufig möchten Sie eine Anweisung auszuführen, wenn eine bestimmte Bedingung erfüllt ist und eine andere Anweisung, falls sie nicht erfüllt ist. Dafür gibt es <literal>else</literal>. - <literal>Else</literal> erweitert eine - <literal>if</literal>-Anweisung um die Ausführung von Anweisungen, - sobald der Ausdruck der <literal>if</literal>-Anweisung als - &false; ausgewertet wird. Der folgende Code wird z.B. - <computeroutput>a ist größer als b</computeroutput> anzeigen, - wenn <replaceable>$a</replaceable> größer ist als - <replaceable>$b</replaceable>, anderenfalls + <literal>else</literal> erweitert eine <literal>if</literal>-Anweisung um + die Ausführung von Anweisungen, sobald der Ausdruck der + <literal>if</literal>-Anweisung als &false; ausgewertet wird. Der folgende + Code wird z.B. <computeroutput>a ist größer als b</computeroutput> + ausgeben, wenn <replaceable>$a</replaceable> größer als + <replaceable>$b</replaceable> ist, anderenfalls <computeroutput>a ist NICHT größer als b</computeroutput>: <informalexample> <programlisting role="php"> <![CDATA[ +<?php if ($a > $b) { print "a ist größer als b"; } else { print "a ist NICHT größer als b"; } +?> ]]> </programlisting> </informalexample> @@ -124,29 +128,29 @@ <sect1 id="control-structures.elseif"> <title><literal>elseif</literal></title> <para> - <literal>Elseif</literal> ist, wie der Name schon sagt, eine + Wie der Name schon sagt ist <literal>elseif</literal> eine Verbindung von <literal>if</literal> und <literal>else</literal>. Wie <literal>else</literal> erweitert sie eine - <literal>if</literal>-Anweisung um die Ausführung anderer - Anweisungen, sobald die normale <literal>if</literal>-Bedingung - als &false; angesehen wird. Anders als bei - <literal>else</literal> wird die Ausführung dieser alternativen - Anweisungen nur durchgeführt, wenn die bei - <literal>elseif</literal> angegebene alternative Bedingung als - &true; angesehen wird. Der folgende Code wird - z.B. <computeroutput>a ist größer als b</computeroutput>, + <literal>if</literal>-Anweisung um die Ausführung anderer Anweisungen, + sobald die normale <literal>if</literal>-Bedingung als &false; ausgewertet + wird. Anders als bei <literal>else</literal> wird die Ausführung dieser alternativen + Anweisungen nur durchgeführt, wenn die bei <literal>elseif</literal> + angegebene alternative Bedingung als &true; ausgewertet wird. Der folgende + Code wird z.B. <computeroutput>a ist größer als b</computeroutput>, <computeroutput>a ist gleich b</computeroutput> oder <computeroutput>a ist kleiner als b</computeroutput> ausgeben: <informalexample> <programlisting role="php"> <![CDATA[ +<?php if ($a > $b) { - print "a ist größer als b"; + echo "a ist größer als b"; } elseif ($a == $b) { - print "a ist gleich b"; + echo "a ist gleich b"; } else { - print "a ist kleiner als b"; + echo "a ist kleiner als b"; } +?> ]]> </programlisting> </informalexample> @@ -154,32 +158,29 @@ <simpara> Es kann mehrere <literal>elseif</literal>-Anweisungen innerhalb einer <literal>if</literal>-Anweisung geben. Die erste - <literal>elseif</literal>-Bedingung (falls vorhanden), die - &true; ist, wird ausgeführt. In PHP kann man - auch 'else if' schreiben (zwei Wörter). Das Verhalten ist - identisch zu 'elseif' (ein Wort). Die Bedeutung der Syntax ist leicht - unterschiedlich (falls Sie mit C vertraut sind, das ist das gleiche - Verhalten) aber der Grundtenor ist der, dass beide Schreibweisen, bezogen - auf das Ergebnis, sich exakt gleich verhalten. + <literal>elseif</literal>-Bedingung (falls vorhanden), die &true; ist, + wird ausgeführt. In PHP kann man auch 'else if' schreiben (zwei Wörter). + Das Verhalten ist identisch zu 'elseif' (ein Wort). Die Bedeutung der + Syntax ist leicht unterschiedlich (falls Sie mit C vertraut sind, das ist + das gleiche Verhalten) aber der Grundtenor ist der, dass beide + Schreibweisen, bezogen auf das Ergebnis, sich exakt gleich verhalten. </simpara> <simpara> - Die <literal>elseif</literal>-Anweisung wird nur ausgeführt, - wenn die vorausgehende <literal>if</literal>-Bedingung sowie - jede vorherige <literal>elseif</literal>-Bedingung - &false; ist und die aktuelle - <literal>elseif</literal>-Bedingung &true; ist. + Die <literal>elseif</literal>-Anweisung wird nur ausgeführt, wenn die + vorausgehende <literal>if</literal>-Bedingung sowie jede vorherige + <literal>elseif</literal>-Bedingung als &false; ausgewertet wird und die + aktuelle <literal>elseif</literal>-Bedingung &true; ist. </simpara> </sect1> <sect1 id="control-structures.alternative-syntax"> <title>Alternative Syntax für Kontroll-Strukturen</title> <para> - PHP bietet eine alternative Syntax für einige seiner - Kontroll-Strukturen, als da sind <literal>if</literal>, - <literal>while</literal>, <literal>for</literal>, - <literal>foreach</literal> und <literal>switch</literal>. - Immer muss die öffnende Klammer durch einen Doppelpunkt - ":" und die schließende Klammer durch ein + PHP bietet eine alternative Syntax für einige seiner Kontroll-Strukturen, + als da sind <literal>if</literal>, <literal>while</literal>, + <literal>for</literal>, <literal>foreach</literal> und + <literal>switch</literal>. Die öffnende Klammer muss immer durch einen + Doppelpunkt ":" und die schließende Klammer entsprechend durch <literal>endif;</literal>, <literal>endwhile;</literal>, <literal>endfor;</literal>, <literal>endforeach;</literal> oder <literal>endswitch;</literal> ersetzt werden. @@ -187,7 +188,7 @@ <programlisting role="php"> <![CDATA[ <?php if ($a == 5): ?> - A ist gleich 5 +A ist gleich 5 <?php endif; ?> ]]> </programlisting> @@ -195,26 +196,28 @@ </para> <simpara> Im obigen Beispiel ist der HTML-Bereich "A ist gleich 5" in eine - <literal>if</literal>-Anweisung mit alternativer Syntax eingebettet. - Der HTML-Bereich wird nur ausgegeben, wenn $a gleich 5 ist. + <literal>if</literal>-Anweisung mit alternativer Syntax eingebettet. Der + HTML-Bereich wird nur ausgegeben, wenn $a gleich 5 ist. </simpara> <para> - Die alternative Syntax kann auch auf <literal>else</literal> - und <literal>elseif</literal> angewendet werden. Es folgt eine + Die alternative Syntax kann auch auf <literal>else</literal> und + <literal>elseif</literal> angewendet werden. Es folgt eine <literal>if</literal>-Struktur mit <literal>elseif</literal> und <literal>else</literal> im alternativen Format: <informalexample> <programlisting role="php"> <![CDATA[ +<?php if ($a == 5): - print "a ist gleich 5"; - print "..."; + echo "a ist gleich 5"; + echo "..."; elseif ($a == 6): - print "a ist gleich 6"; - print "!!!"; + echo "a ist gleich 6"; + echo "!!!"; else: - print "a ist weder 5 noch 6"; + echo "a ist weder 5 noch 6"; endif; +?> ]]> </programlisting> </informalexample> @@ -229,9 +232,9 @@ <sect1 id="control-structures.while"> <title><literal>while</literal></title> <para> - <literal>While</literal>-Schleifen sind die einfachste Form von - Schleifen in PHP. Sie funktionieren genau wie in C. Die - Grundform einer <literal>while</literal>-Anweisung lautet: + Die <literal>while</literal>-Schleifen sind die einfachste Form von + Schleifen in PHP. Sie funktionieren genau wie in C. Die Grundform einer + <literal>while</literal>-Anweisung lautet: <informalexample> <programlisting> <![CDATA[ @@ -249,15 +252,15 @@ innerhalb der <literal>while</literal>-Schleife verändert, endet die Ausführung dieses Anweisungsblocks erst mit dem Ende der Iteration (Jeder Schleifendurchlauf ist eine Iteration). Falls die - <literal>while</literal>-Bedingung bereits zu Beginn &false; ist, werden - die Anweisungen der <literal>while</literal>-Schleife nicht ein einziges - Mal durchlaufen. + <literal>while</literal>-Bedingung bereits beim ersten Mal &false; ist, + werden die Anweisungen der <literal>while</literal>-Schleife nicht ein + einziges Mal durchlaufen. </simpara> <para> - Wie bei der <literal>if</literal>-Anweisung kann man mehrere - Anweisungen innerhalb der gleichen <literal>while</literal>-Schleife angeben, - indem man sie mit geschweiften Klammern umschließt oder die alternative - Syntax gebraucht: + Wie bei der <literal>if</literal>-Anweisung können Sie mehrere + Anweisungen innerhalb der gleichen <literal>while</literal>-Schleife + angeben, indem Sie dieses mit geschweiften Klammern umschließen oder die + alternative Syntax verwenden: <informalexample> <programlisting> <![CDATA[ @@ -276,16 +279,15 @@ $i = 1; while ($i <= 10) { - print $i++; /* es wird erst $i ausgegeben, - bevor der Wert erhöht wird - (Post-Inkrement) */ + echo $i++; /* es wird erst $i ausgegeben, bevor der Wert erhöht wird + (Post-Inkrement) */ } /* Beispiel 2 */ $i = 1; while ($i <= 10): - print $i; + echo $i; $i++; endwhile; ]]> @@ -296,59 +298,61 @@ <sect1 id="control-structures.do.while"> <title><literal>do..while</literal></title> <simpara> - <literal>Do..while</literal>-Schleifen sind den <literal>while</literal> - -Schleifen sehr ähnlich, außer dass der Wahrheitsgehalt des Ausdrucks erst am - Ende jedes Durchlaufs geprüft wird, statt am Anfang. Der Hauptunterschied + <literal>do..while</literal>-Schleifen sind den <literal>while</literal> + -Schleifen sehr ähnlich, außer dass der Wahrheitsgehalt des Ausdrucks erst + am Ende jedes Durchlaufs geprüft wird, statt am Anfang. Der Hauptunterschied zu gewöhnlichen <literal>while</literal>-Schleifen ist der, dass die Schleife bei <literal>do..while</literal> in jeden Fall einmal durchlaufen wird - (die Bedingung wird erst am Ende einer Iteration geprüft), - wogegen es bei <literal>while</literal>-Schleifen - durchaus passieren kann, dass die Schleife nie durchlaufen wird (die - Bedingung wird immer am Anfang eines Durchlaufs überprüft. Wird diese - Bedingung von Anfang an als &false; ausgewertet endet die Ausführung - der Schleife sofort). + (die Bedingung wird erst am Ende eines Durchlaufs geprüft).Bei + <literal>while</literal>-Schleifen hingegen kann es durchaus passieren, + dass die Schleife nie durchlaufen wird (die Bedingung wird immer am Anfang + eines Durchlaufs überprüft. Wird diese Bedingung von Anfang an als &false; + ausgewertet endet die Ausführung der Schleife sofort). </simpara> <para> Es gibt nur eine Syntax für <literal>do..while</literal>-Schleifen: <informalexample> <programlisting role="php"> <![CDATA[ +<?php $i = 0; do { - print $i; + echo $i; } while ($i>0); +?> ]]> </programlisting> </informalexample> </para> <simpara> Die obige Schleife wird genau einmal durchlaufen, da nach der - ersten Wiederholung die Erfüllung der Bedingung geprüft wird. Da - diese aber nicht erfüllt, also &false; ist ($i ist nicht größer als 0), - wird die Schleifenausführung beendet. + ersten Wiederholung die Erfüllung der Bedingung geprüft wird. Diese + Bedingung ist aber nicht erfüllt ($i ist nicht größer als 0), wird als + &false; ausgewertet, und die Schleifenausführung beendet. </simpara> <para> Erfahrene C-Anwender kennen auch die Möglichkeit, Programm-Blöcke - mit <literal>do..while</literal>(0) einzuschliessen und dann die + mit <literal>do..while</literal> (0) einzuschliessen und dann die <link linkend="control-structures.break"><literal>break</literal></link> - Anweisung zu benutzen. Der folgende Programm-Ausschnitt zeigt dies: + Anweisung zu benutzen. Der folgende Programm-Ausschnitt zeigt diese + Möglichkeit: <informalexample> <programlisting role="php"> <![CDATA[ do { if ($i < 5) { - print "i ist nicht groß genug"; + echo "i ist nicht groß genug"; break; } $i *= $factor; if ($i < $minimum_limit) { break; } - print "i ist ok"; + echo "i ist ok"; - ...bearbeite i... + /* mach was mit i */ -} while(0); +} while (0); ]]> </programlisting> </informalexample> @@ -363,9 +367,9 @@ <sect1 id="control-structures.for"> <title><literal>for</literal></title> <para> - <literal>For</literal>-Schleifen sind die komplexesten Schleifen - in PHP. Sie funktionieren wie ihr Gegenstück in C. Die Syntax - einer <literal>for</literal>-Schleife sieht so aus: + Die <literal>for</literal>-Schleifen sind die komplexesten Schleifen in + PHP. Sie funktionieren wie ihr Gegenstück in C. Die Syntax einer + <literal>for</literal>-Schleife sieht wie folgt aus: <informalexample> <programlisting> <![CDATA[ @@ -380,20 +384,19 @@ </simpara> <simpara> Zu Beginn jedes Durchlaufs wird nun <replaceable>ausdr2</replaceable> - geprüft. Wenn dieser &true; ist, fährt die Schleife - fort mit der Ausführung der nachfolgenden Anweisung. Ist das - Ergebnis &false;, wird die Schleife beendet. + geprüft. Wenn dieser &true; ist, fährt die Schleife mit der Ausführung der + nachfolgenden Anweisung(en) fort. Ist das Ergebnis &false;, wird die + Schleife beendet. </simpara> <simpara> Am Ende jedes Durchlaufs wird <replaceable>ausdr3</replaceable> geprüft (ausgeführt). </simpara> <simpara> - Jeder Ausdruck kann leer sein. - Ist <replaceable>ausdr2</replaceable> leer, wird die Schleife endlos oft - durchlaufen (PHP wertet diesen, wie in C, implizit als &true;). Das ist - nicht so sinnlos, wie Sie vielleicht glauben, weil man häufig eine - Schleife erst durch eine bedingte + Jeder Ausdruck kann leer sein. Ist <replaceable>ausdr2</replaceable> leer, + wird die Schleife endlos oft durchlaufen (PHP wertet diesen, wie in C, + implizit als &true;). Das ist gar nicht so sinnlos, wie Sie vielleicht + zunächst glauben, weil man häufig eine Schleife erst durch eine bedingte <link linkend="control-structures.break"><literal>break</literal> </link>-Anweisung statt durch eine unwahr werdende <literal>for</literal>-Bedingung beenden möchte. @@ -404,44 +407,46 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php /* Beispiel 1 */ - + for ($i = 1; $i <= 10; $i++) { - print $i; + echo $i; } - + /* Beispiel 2 */ -for ($i = 1;;$i++) { +for ($i = 1; ; $i++) { if ($i > 10) { break; } - print $i; + echo $i; } /* Beispiel 3 */ - + $i = 1; -for (;;) { +for (; ; ) { if ($i > 10) { break; } - print $i; + echo $i; $i++; } /* Beispiel 4 */ - -for ($i = 1; $i <= 10; print $i, $i++) ; + +for ($i = 1; $i <= 10; echo $i, $i++); +?> ]]> </programlisting> </informalexample> </para> <simpara> - Selbstverständlich sieht das erste (oder vielleicht das vierte) Beispiel am - besten aus, aber Sie werden noch feststellen, dass es oftmals ganz - nützlich sein kann, leere Parameter in - <literal>for</literal>-Schleifen zu verwenden. + Selbstverständlich sieht das erste (oder vielleicht das vierte) Beispiel + am besten aus, aber Sie werden noch feststellen, dass es oftmals ganz + nützlich sein kann, leere Parameter in <literal>for</literal>-Schleifen zu + verwenden. </simpara> <para> PHP unterstützt auch bei <literal>for</literal>-Schleifen die @@ -455,14 +460,14 @@ </informalexample> </para> <para> - Andere Sprachen haben für das Durchlaufen eines Hash´s oder - Arrays eine <literal>foreach</literal>-Anweisung. PHP 3 hat dies - nicht; im Gegensatz zu PHP 4 (vgl. + Andere Sprachen haben für das Durchlaufen eines Hashs oder Arrays eine + <literal>foreach</literal>-Anweisung. PHP 3 hat dies nicht; im Gegensatz + zu PHP 4 (vgl. <link linkend="control-structures.foreach">foreach</link>). - In PHP 3 kann man dafür eine Kombination von + In PHP 3 können Sie für diesen Zweck <link linkend="control-structures.while">while</link> mit der <function>list</function>- und <function>each</function>-Funktion - einsetzen. Beispiele finden Sie in der Dokumentation zu diesen + kombinieren. Beispiele finden Sie in der Dokumentation zu diesen Funktionen. </para> </sect1> @@ -474,25 +479,25 @@ genau wie Perl und einige andere Sprachen. Diese ermöglicht es, auf einfache Weise ein Array zu durchlaufen. <literal>foreach</literal> funktioniert nur in Verbindung mit Arrays. Wenn Sie versuchen - <literal>foreach</literal> mit einer Variable eines anderen Datentyps oder - einer nicht initialisierten Variable zu benutzen, gibt PHP einen Fehler - aus. Es gibt zwei Syntax-Formen; die zweite ist eine unbedeutende, aber - sinnvolle Erweiterung der ersten Syntax: + <literal>foreach</literal> mit Variablen eines anderen Datentyps oder + nicht initialisierten Variablen zu benutzen, gibt PHP einen Fehler aus. Es + gibt zwei Syntaxformen; die zweite ist eine unbedeutende, aber sinnvolle + Erweiterung der ersten Syntax: <informalexample> <programlisting> <![CDATA[ -foreach(array_expression as $value) Anweisung -foreach(array_expression as $key => $value) Anweisung +foreach (array_expression as $value) Anweisung +foreach (array_expression as $key => $value) Anweisung ]]> </programlisting> </informalexample> </para> <simpara> - Die erste Form durchläuft das - <literal>array_expression</literal>-Array. Bei jedem Durchgang wird - der Wert des aktuellen Elements <literal>$value</literal> zugewiesen - und der interne Array-Zeiger um eins erhöht. Dadurch wird beim nächsten - Durchgang automatisch das nächste Element ausgewertet. + Die erste Form durchläuft das <literal>array_expression</literal>-Array. + Bei jedem Durchgang wird der Wert des aktuellen Elements + <literal>$value</literal> zugewiesen und der interne Array-Zeiger um eins + erhöht. Dadurch wird beim nächsten Durchgang automatisch das nächste + Element ausgewertet. </simpara> <simpara> Die zweite Form arbeitet genauso, außer dass bei jedem Durchlauf @@ -503,8 +508,8 @@ <note> <para> Sobald <literal>foreach</literal> zum ersten Mal ausgeführt wird, - wird der interne Array-Pointer automatisch auf das erste Element - des Arrays zurück gesetzt. Das bedeutet, dass Sie vor einem Durchlauf + wird der interne Arrayzeiger automatisch auf das erste Element + des Arrays gesetzt. Das bedeutet, dass Sie vor einem Durchlauf von <literal>foreach</literal> <function>reset</function> nicht aufrufen müssen. </para> @@ -515,7 +520,7 @@ <para> Beachten Sie auch, dass <literal>foreach</literal> mit einer Kopie des angegebenen Arrays arbeitet, nicht mit dem Array selbst. - Deshalb wird auch der Array-Pointer nicht wie bei dem + Deshalb wird auch der Arrayzeiger nicht wie bei dem <function>each</function>-Konstrukt verändert und Veränderungen an ausgegebenen Arrayelementen haben keine Auswirkung auf das originale Array. Trotzdem <emphasis>wird</emphasis> der interne Arrayzeiger @@ -527,8 +532,8 @@ </para> <note> <para> - Fehlermeldungen durch den Gebrauch von '@' zu unterdrücken ist bei - <literal>foreach</literal> nicht möglich. + Bei <literal>foreach</literal> ist es nicht möglich Fehlermeldungen durch + den Gebrauch von '@' zu unterdrücken ist </para> </note> <para> @@ -537,13 +542,16 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php +$arr = array("eins", "zwei", "drei"); reset ($arr); while (list(, $value) = each ($arr)) { - echo "Wert: $value<br>\n"; + echo "Wert: $value<br />\n"; } foreach ($arr as $value) { - echo "Wert: $value<br>\n"; + echo "Wert: $value<br />\n"; +?> } ]]> </programlisting> @@ -552,14 +560,17 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php +$arr = array("eins", "zwei", "drei"); reset ($arr); while (list($key, $value) = each ($arr)) { - echo "Schlüssel: $key; Wert: $value<br>\n"; + echo "Schlüssel: $key; Wert: $value<br />\n"; } foreach ($arr as $key => $value) { - echo "Schlüssel: $key; Wert: $value<br>\n"; + echo "Schlüssel: $key; Wert: $value<br />\n"; } +?> ]]> </programlisting> </informalexample> @@ -569,29 +580,30 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php /* foreach Beispiel 1: Nur der Wert */ -$a = array (1, 2, 3, 17); +$a = array(1, 2, 3, 17); foreach ($a as $v) { - print "Aktueller Wert von \$a: $v.\n"; + echo "Aktueller Wert von \$a: $v.\n"; } /* foreach Beispiel 2: -Wert (mit Ausgabe des Array-Schlüssels zur Veranschaulichung) */ +Wert (mit Ausgabe des Arrayschlüssels zur Veranschaulichung) */ -$a = array (1, 2, 3, 17); +$a = array(1, 2, 3, 17); $i = 0; /* nur zu Veranschaulichung */ foreach($a as $v) { - print "\$a[$i] => $v.\n"; + echo "\$a[$i] => $v.\n"; $i++; } /* foreach Beispiel 3: Schlüssel und Wert */ -$a = array ( +$a = array( "eins" => 1, "zwei" => 2, "drei" => 3, @@ -599,7 +611,7 @@ ); foreach($a as $k => $v) { - print "\$a[$k] => $v.\n"; + echo "\$a[$k] => $v.\n"; } /* foreach Beispiel 4: multidimensionale Arrays */ @@ -611,15 +623,16 @@ foreach($a as $v1) { foreach ($v1 as $v2) { - print "$v2\n"; + echo "$v2\n"; } } /* foreach Beispiel 5: dynamische Arrays */ -foreach(array(1, 2, 3, 4, 5) as $v) { - print "$v\n"; +foreach (array(1, 2, 3, 4, 5) as $v) { + echo "$v\n"; } +?> ]]> </programlisting> </informalexample> @@ -631,40 +644,42 @@ <simpara> <literal>Break</literal> bricht die Ausführung der aktuellen <literal>for</literal>, <literal>foreach</literal> - <literal>while</literal>, <literal>do..while</literal> or - <literal>switch</literal> - Anweisungs-Sequenz ab. + <literal>while</literal>, <literal>do..while</literal> Schleife oder einer + <literal>switch</literal> Anweisungssequenz ab. </simpara> <simpara> Einem <literal>break</literal> kann optional ein nummerisches Argument angehängt werden, das die Anzahl der abzubrechenden - Befehls-Sequenzen enthält. + Befehlssequenzen enthält. </simpara> <para> <informalexample> <programlisting role="php"> <![CDATA[ -$arr = array ('eins', 'zwei', 'drei', 'vier', 'stop', 'fünf'); +<?php +$arr = array('eins', 'zwei', 'drei', 'vier', 'stop', 'fünf'); while (list ( , $val) = each ($arr)) { if ($val == 'stop') { - break; /* Man kann hier auch 'break 1;' schreiben. */ + break; /* Sie könnten hier auch 'break 1;' schreiben. */ } - echo "$val<br>\n"; + echo "$val<br />\n"; /* Benutzung des optionalen Argumentes. */ + $i = 0; - while (++$i) { - switch ($i) { - case 5: - echo "Bei 5<br>\n"; - break 1; /* Beendet nur switch. */ - case 10: - echo "Bei 10; quitting<br>\n"; - break 2; /* Beendet switch und while. */ - default: - break; +while (++$i) { + switch ($i) { + case 5: + echo "Bei 5<br />\n"; + break 1; /* Beendet nur switch. */ + case 10: + echo "Bei 10; aussteigen<br />\n"; + break 2; /* Beendet switch und while. */ + default: + break; } } +?> ]]> </programlisting> </informalexample> @@ -674,21 +689,30 @@ <sect1 id="control-structures.continue"> <title><literal>continue</literal></title> <simpara> - <literal>Continue</literal> wird innerhalb von Schleifen - gebraucht. Die Schleife wird an der aktuellen Stelle abgebrochen - und es wird der nächste Durchlauf begonnen. + <literal>continue</literal> wird innerhalb von Schleifen verwendet. Die + Schleife wird an der aktuellen Stelle abgebrochen und es wird der nächste + Durchlauf begonnen. </simpara> + <note> + <simpara> + Beachten Sie, dass in PHP die + <link linkend="control-structures.switch">switch</link> Anweisung + als Schleifenstruktur zum Zweck von <literal>continue</literal> angesehen + wird. + </simpara> + </note> <simpara> - <literal>Continue</literal> kann optional ein nummerisches - Argument erhalten, das angibt, wie viele Ebenen von enhaltenen Schleifen + Bei <literal>continue</literal> können Sie ein optionales nummerisches + Argument mitgeben, das angibt, wie viele Ebenen von enhaltenen Schleifen übersprungen werden sollen. </simpara> <para> <informalexample> <programlisting role="php"> <![CDATA[ +<?php while (list ($key, $value) = each ($arr)) { - if ($key % 2) { // überspringe ungerade Werte + if (!($key % 2)) { // überspringe ungerade Werte continue; } tue_was_mit_ungerade ($value); @@ -696,23 +720,68 @@ $i = 0; while ($i++ < 5) { - echo "Außn<br>\n"; + echo "Außen<br />\n"; while (1) { - echo " Mitte<br>\n"; + echo " Mitte<br />\n"; while (1) { - echo " Innen<br>\n"; + echo " Innen<br />\n"; continue 3; } - echo "Das wird nie ausgegeben.<br>\n"; + echo "Das wird nie ausgegeben.<br />\n"; } - echo "Dies auch nicht.<br>\n"; + echo "Das hier auch nicht.<br />\n"; } +?> ]]> </programlisting> </informalexample> </para> + <para> + Lassen Sie das Semikolon nach <literal>continue</literal> weg, kann dies + zu verwirrenden Ergebnissen führen. Es folgt ein Beispiel wie Sie es + nicht machen sollten. + </para> + <para> + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php + for ($i = 0; $i < 5; ++$i) { + if ($i == 2) + continue + print "$i\n"; + } +?> +]]> + </programlisting> + <para> + Sie könnten erwarten, dass das Ergebnis wie folgt aussieht, + </para> + <screen> +<![CDATA[ +0 +1 +3 +4 +]]> + </screen> + <para> + aber tatsächlich sieht die Ausgabe so aus, + </para> + <screen> +<![CDATA[ +2 +]]> + </screen> + <para> + weil der Rückgabewert von <function>print</function> + <literal>int(1)</literal> ist und das wird als das oben angesprochene + optinale Argument gewertet. + </para> + </informalexample> + </para> </sect1> - + <sect1 id="control-structures.switch"> <title><literal>switch</literal></title> <simpara> @@ -722,135 +791,148 @@ mit verschiedensten Werten vergleichen und in Abhängigkeit vom Auswertungsergebnis verschiedene Programmteile ausführen. Genau das ermöglicht die <literal>switch</literal>-Anweisung. - </simpara> + </simpara> + <note> + <simpara> + Beachten Sie bitte, dass im Unterschied zu anderen Programmiersprachen + die <link linkend="control-structures.continue">continue</link> + Anweisung auch bei switch ihre Gültigkeit hat und ähnlich wie + <literal>break</literal> funktioniert. Falls Sie switch innerhalb einer + Schleife verwenden und mit dem nächsten Durchlauf der äußeren Schleife + beginnen möchten, verwenden Sie <literal>continue 2</literal>. + </simpara> + </note> <para> - Die folgenden zwei Beispiele zeigen zwei verschiedene Wege, das Gleiche - zu bewirken; eines gebraucht mehrere <literal>if</literal>-Anweisungen, - das andere eine <literal>switch</literal>-Anweisung: + Das folgende Beispiele zeigt Ihnen zwei verschiedene Möglichkeiten auf, + das Gleiche zu erreichen. Einmal werden <literal>if</literal> und + <literal>elseif</literal> Anweisungen benutzt, das andere Mal eine + <literal>switch</literal>-Anweisung: <informalexample> <programlisting role="php"> <![CDATA[ +<?php if ($i == 0) { - print "i ist gleich 0"; + echo "i ist gleich 0"; +} elseif ($i == 1) { + echo "i ist gleich 1"; +} elseif ($i == 2) { + echo "i ist gleich 2"; } -if ($i == 1) { - print "i ist gleich 1"; -} -if ($i == 2) { - print "i ist gleich 2"; -} - + switch ($i) { - case 0: - print "i ist gleich 0"; - break; - case 1: - print "i ist gleich 1"; - break; - case 2: - print "i ist gleich 2"; - break; +case 0: + echo "i ist gleich 0"; + break; +case 1: + echo "i ist gleich 1"; + break; +case 2: + echo "i ist gleich 2"; + break; } +?> ]]> </programlisting> </informalexample> </para> <para> - Es ist wichtig, die Ausführung einer - <literal>switch</literal>-Anweisung zu verstehen, um Fehler zu - vermeiden. Die <literal>switch</literal>-Anweisung wird Zeile für - Zeile (also Anweisung für Anweisung) abgearbeitet. Zu Beginn wird - nichts ausgeführt. Erst wenn bei einem <literal>case</literal>-Teil - eine Entsprechung zum <literal>switch</literal>-Ausdruck vorliegt, - werden die darin enthaltenen Anweisungen von PHP ausgeführt. PHP fährt - dann mit der Abarbeitung des restlichen Codes innerhalb des - <literal>switch</literal>-Blocks fort oder bis zum ersten - Auftreten einer <literal>break</literal>-Anweisung. Ohne + Es ist wichtig, die Ausführung einer <literal>switch</literal>-Anweisung + zu verstehen, um Fehler zu vermeiden. Die <literal>switch</literal>-Anweisung + wird Zeile für Zeile (also Anweisung für Anweisung) abgearbeitet. Zu + Beginn wird kein Code ausgeführt. Erst wenn bei einem + <literal>case</literal>-Teil eine Entsprechung zum + <literal>switch</literal>-Ausdruck vorliegt, werden die darin enthaltenen + Anweisungen von PHP ausgeführt. PHP fährt dann mit der Abarbeitung des + restlichen Codes innerhalb des <literal>switch</literal>-Blocks fort oder + bis zum ersten Auftreten einer <literal>break</literal>-Anweisung. Ohne <literal>break</literal> am Ende eines case-Teils werden also - noch die folgenden case-Blöcke ausgeführt. - Zum Beispiel: + noch die folgenden case-Blöcke ausgeführt. Zum Beispiel: <informalexample> <programlisting role="php"> <![CDATA[ +<?php switch ($i) { - case 0: - print "i ist gleich 0"; - case 1: - print "i ist gleich 1"; - case 2: - print "i ist gleich 2"; +case 0: + echo "i ist gleich 0"; +case 1: + echo "i ist gleich 1"; +case 2: + echo "i ist gleich 2"; } +?> ]]> </programlisting> </informalexample> </para> <simpara> - Wenn hier $i gleich 0 ist, würde PHP alle print-Anweisungen - ausführen! Ist $i gleich 1, werden die letzten beiden - print-Befehle ausgeführt und wenn $i = 2 ist, wird nur der - letzte print-Befehl ausgeführt. Deshalb ist es wichtig - <literal>break</literal>-Anweisungen zu setzen (abgesehen von - bestimmten Fällen, in denen Sie diese mit Absicht weglassen). - </simpara> - <simpara> - Bei einer <literal>switch</literal>-Anweisung wird die - Bedingung also nur einmal überprüft und das Ergebnis mit jeder - <literal>case</literal>-Anweisung verglichen. Bei einem - <literal>elseif</literal>-Befehl wird die Bedingung neu geprüft. - Ist ihre Bedingung komplizierter als ein einfacher Vergleich - und/oder in einer umfangreichen Schleife eingebettet, kann - eine <literal>switch</literal>-Anweisung schneller als - mehrere <literal>if</literal>-Befehle sein. + Wenn hier $i gleich 0 ist, würde PHP alle echo Anweisungen ausführen! Ist + $i gleich 1, werden die letzten beiden echo Anweisungen ausgeführt. Nur + wenn $i = 2 ist, erhalten Sie das erwartete Ergebnis: die Ausgabe von + "i ist gleich 2". Deshalb ist es wichtig <literal>break</literal>-Anweisungen + zu setzen (abgesehen von bestimmten Fällen, in denen Sie diese mit Absicht + weglassen). + </simpara> + <simpara> + Bei einer <literal>switch</literal>-Anweisung wird die Bedingung also nur + einmal überprüft und das Ergebnis mit jeder <literal>case</literal>-Anweisung + verglichen. Bei einer <literal>elseif</literal>-Anweisung wird die + Bedingung neu geprüft. Ist ihre Bedingung komplizierter als ein einfacher + Vergleich und/oder in einer umfangreichen Schleife eingebettet, kann eine + <literal>switch</literal>-Anweisung schneller sein. </simpara> <para> - Der Anweisungsteil von case kann auch leer sein. Dann wird - die Kontrolle einfach an den nächsten case-Teil übergeben. + Der Anweisungsteil von case kann auch leer sein. Dann wird die Kontrolle + einfach an den nächsten case-Teil übergeben. <informalexample> <programlisting role="php"> <![CDATA[ +<?php switch ($i) { - case 0: - case 1: - case 2: - print "i ist kleiner als 3 aber nicht negativ"; - break; - case 3: - print "i ist gleich 3"; +case 0: +case 1: +case 2: + echo "i ist kleiner als 3 aber nicht negativ"; + break; +case 3: + echo "i ist gleich 3"; } +?> ]]> </programlisting> </informalexample> </para> <para> - Ein Spezialfall ist default. Dieser Fall trifft + Ein Spezialfall ist <literal>default</literal>. Dieser Fall trifft auf alles zu, was nicht von den voranstehenden case-Ausdrücken erfasst wurde und sollte als letzte <literal>case</literal> Anweisung angegeben werden. Zum Beispiel: <informalexample> <programlisting role="php"> <![CDATA[ +<?php switch ($i) { - case 0: - print "i ist gleich 0"; - break; - case 1: - print "i ist gleich 1"; - break; - case 2: - print "i ist gleich 2"; - break; - default: - print "i ist weder 0, 1 noch 2"; +case 0: + echo "i ist gleich 0"; + break; +case 1: + echo "i ist gleich 1"; + break; +case 2: + echo "i ist gleich 2"; + break; +default: + echo "i ist weder 0, 1 noch 2"; } +?> ]]> </programlisting> </informalexample> </para> <para> - Der <literal>case</literal>-Ausdruck kann eine Prüfung einfacher - Typen sein, also von Integer- oder Fließkomma-Zahlen oder von - Strings/Zeichenketten. Arrays oder Objekte können nicht benutzt - werden, es sei denn, sie wurden in einfache Typen umgewandelt. + Der <literal>case</literal>-Ausdruck kann eine Prüfung einfacher Typen + sein, also von Integer- oder Fließkomma-Zahlen oder von + Strings/Zeichenketten. Arrays oder Objekte können nicht benutzt werden, es + sei denn, sie wurden in einfache Typen umgewandelt. </para> <para> Die alternative Syntax der Kontrollstrukturen gilt auch für @@ -860,19 +942,21 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php switch ($i): - case 0: - print "i ist gleich 0"; - break; - case 1: - print "i ist gleich 1"; - break; - case 2: - print "i ist gleich 2"; - break; - default: - print "i ist weder 0, 1 noch 2"; +case 0: + echo "i ist gleich 0"; + break; +case 1: + echo "i ist gleich 1"; + break; +case 2: + echo "i ist gleich 2"; + break; +default: + echo "i ist weder 0, 1 noch 2"; endswitch; +?> ]]> </programlisting> </informalexample> @@ -895,9 +979,9 @@ </informalexample> </para> <para> - Die <literal>Directive</literal> gibt Ihnen die Möglichkeit, das + Die <literal>Direktive</literal> gibt Ihnen die Möglichkeit, das Verhalten des <literal>declare</literal>-Blocks zu bestimmen. - Zur Zeit wird nur eine Direktive erkannt: die <literal>ticks</literal> + Zur Zeit wird nur eine Direktive unterstützt: die <literal>ticks</literal> (Weiter unten finden Sie mehr Informationen zu den <link linkend="control-structures.declare.ticks">ticks</link>). </para> @@ -907,6 +991,28 @@ Nebeneffekte während der Ausführung auftreten, hängt von der Direktive ab, die Sie im <literal>directive</literal>-Block angegeben haben. </para> + <para> + Das <literal>declare</literal> Konstrukt kann auch im globalen + Geltungsbereich benutzt werden und gilt dann für den folgenden Code. + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +// bewirkt das Gleiche: + +// sie können declare so benutzen: +declare(ticks=1) { + // hier folgt Ihr ganzes Skript +} + +// oder wie hier: +declare(ticks=1); +// hier folgt Ihr ganzes Skript +?> +]]> + </programlisting> + </informalexample> + </para> <sect2 id="control-structures.declare.ticks"> <title>Ticks</title> @@ -932,7 +1038,7 @@ <![CDATA[ <?php // Funktion, die bei Aufruf die Zeit aufzeichnet -function profile ($dump = FALSE) +function profile($dump = FALSE) { static $profile; @@ -950,18 +1056,18 @@ register_tick_function("profile"); // Funktion vor dem declare-Block initialisieren -profile (); +profile(); // Ausführen eines Code-Blocks, jede 2te Anweisung löst einen tick aus -declare (ticks=2) { +declare(ticks=2) { for ($x = 1; $x < 50; ++$x) { - echo similar_text (md5($x), md5($x*$x)), "<br />;"; + echo similar_text(md5($x), md5($x*$x)), "<br />;"; } } // Ausgabe der gespeicherten Daten aus dem Profiler -print_r (profile (TRUE)); +print_r(profile (TRUE)); ?> ]]> </programlisting> @@ -969,9 +1075,9 @@ Dieses Beispiel 'profiliert' den PHP Code der im 'declare'-Block steht, indem die Zeit festgehalten wird, zu der jede zweite low-level Anweisung im Codeblock ausgeführt wird. Diese Information können Sie dazu benutzen, - langsame Bereiche innerhalb bestimmter Codesegmente zu idebtifizieren. - Das gleiche Ziel können Sie auch mit anderen Methoden erreichen: die - Benutzung von ticks ist bequemer und einfacher zu implementieren. + langsame Bereiche innerhalb bestimmter Codesegmente zu identifizieren. Das + gleiche Ziel können Sie auch mit anderen Methoden erreichen: die Benutzung + von ticks ist bequemer und einfacher zu implementieren. </para> <simpara> Ticks sind gut für Debugging, einfaches Multitasking, @@ -1001,22 +1107,25 @@ aktuelle Skript <function>include</function>ed, wird der Wert, der <function>return</function> zugewiesen wurde, als Wert des Aufrufs von <function>include</function> zurückgegeben. - Wird <function>return</function> inerhalb des Hauptskripts aufgerufen, + Wird <function>return</function> innerhalb des Hauptskripts aufgerufen, wird die Ausführung beendet. Handelt es sich bei dem Skript um eine Datei, die über die Einträge <link linkend="ini.auto-prepend-file">auto_prepend_file</link> oder <link linkend="ini.auto-append-file">auto_append_file</link> - in der <link linkend="configuration.file">Konfigurationsdatei</link> - aufgerufen wurde, wird die Ausführung dieses Skripts beendet. + in der &php.ini; aufgerufen wurde, wird die Ausführung dieses Skripts + beendet. + </simpara> + <simpara>Weitere Informationen erhalten Sie im Abschnitt <link + linkend="functions.returning-values">Rückgabewerte</link>. </simpara> <note> <simpara> Beachten Sie, dass <function>return</function> ein Sprachkonstrukt und - keine Funktion ist. Deshalb brauchen Sie die Klammern um die Argumente - <emphasis>nur</emphasis> dann zu setzen, wenn es sich um einen Ausdruck - handelt, dessen Ergebnis zurückgegeben werden soll. - Es ist gebräuchlich, die Klammern wegzulassen, wenn eine Variable oder - ein Wert dem return-Konstrukt folgt. + keine Funktion ist. Die Klammern um ein Argument sind deshalb + <emphasis>nur</emphasis> zwingend notwendig, wenn es sich um einen + Ausdruck handelt, dessen Ergebnis zurückgegeben werden soll. + Es ist gebräuchlich die Klammern wegzulassen, wenn eine Variable zurück + gegeben soll. </simpara> </note> </sect1> @@ -1024,18 +1133,18 @@ <sect1 id="function.require"> <title><function>require</function></title> <simpara> - Die <function>require</function> Anweisung bindet eine Datei ein und führt - diese aus. + Die <function>require</function> Anweisung bindet die angegebene Datei ein + und wertet diese aus. </simpara> <simpara> - <function>require</function> bindet eine Datei ein und führt + <function>require</function> bindet die angegebene Datei ein und führt diese aus. Genaue Informationen wie die Einbindung funktioniert ist in der Dokumentation für <function>include</function> beschrieben. </simpara> <simpara> - <function>require</function> und <function>include</function> - sind in jeder Hinsicht gleichwertig mit der einen Ausnahme: der - Umgang mit Fehlern. <function>include</function> erzeugt ein + <function>require</function> und <function>include</function> sind in + jeder Hinsicht gleichwertig mit der einen Ausnahme: der Umgang mit + Fehlern. <function>include</function> erzeugt ein <link linkend="internal.e-warning">Warning</link> während <function>require</function> in einem <link linkend="internal.e-error"> Fatal Error</link> endet. Mit anderen Worten: scheuen Sie sich nicht, @@ -1067,22 +1176,29 @@ Weitere Beispiele finden Sie in der Dokumentation zu <function>include</function>. </simpara> - <note> - <simpara> - Für frühere Versionen als PHP 4.0.2 gilt folgendes: - <function>require</function> wird immer versuchen die Zieldatei zu lesen, - selbst wenn die Zeile in der die Anweisung steht, nie ausgeführt wird. Eine - bedingte Anweisung hat keine Auswirkungen auf <function>require</function>. - Wenn jedoch die Zeile in der <function>require</function> steht, nie - ausgeführt wird, wird auch der Code der Zieldatei nie ausgeführt werden. - Ähnliches gilt für Schleifenstrukturen, diese beeinflussen das Verhalten - von <function>require</function> nicht. Obwohl der Code, der in der - Zieldatei enthalten ist, zur Schleife gehört, wird - <function>require</function> selbst nur einmal ausgeführt. - </simpara> - </note> + <para> + <note> + <simpara> + Für frühere Versionen als PHP 4.0.2 gilt folgendes: + <function>require</function> wird immer versuchen die Zieldatei zu lesen, + selbst wenn die Zeile in der die Anweisung steht, nie ausgeführt wird. + Eine bedingte Anweisung hat keine Auswirkungen auf + <function>require</function>. Wenn jedoch die Zeile in der + <function>require</function> steht, nie ausgeführt wird, wird auch der + Code der Zieldatei nie ausgeführt werden. Ähnliches gilt für + Schleifenstrukturen, diese beeinflussen das Verhalten von + <function>require</function> nicht. Obwohl der Code, der in der Zieldatei + enthalten ist, zur Schleife gehört, wird <function>require</function> + selbst nur einmal ausgeführt. + </simpara> + </note> + </para> + + ¬e.language-construct; + &warn.no-win32-fopen-wrapper; - <simpara> + +<simpara> Siehe auch <function>include</function>, <function>require_once</function>, <function>include_once</function>, <function>eval</function>, <function>file</function>, <function>readfile</function>, @@ -1093,8 +1209,8 @@ <sect1 id="function.include"> <title><function>include</function></title> <simpara> - Die <function>include</function>-Anweisung bindet die angegebene Datei - ein und wertet sie aus. + Die <function>include</function> Anweisung bindet die angegebene Datei ein + und wertet diese aus. </simpara> <simpara> Die untenstehende Dokumentation gilt ebenso für @@ -1119,25 +1235,25 @@ </simpara> <para> <example> - <title>Grundlegende <function>include</function> Beispiel</title> + <title>Grundlegendes <function>include</function> Beispiel</title> <programlisting role="php"> <![CDATA[ vars.php <?php -$color = 'green'; -$fruit = 'appel'; +$color = 'grün'; +$fruit = 'Apfel'; ?> test.php <?php -echo "A $color $fruit"; // A +echo "Ein $color $fruit"; // A include 'vars.php'; -echo "A $color $fruit"; // A green apple +echo "Ein $color $fruit"; // Ein grüner Apfel ?> ]]> @@ -1145,11 +1261,10 @@ </example> </para> <simpara> - Steht include im aufrufenden Skript innerhalb einer Funktion, - verhält sich der gesamte Code der aufgerufenen Datei genau so, - als ob Sie diesen Code innerhalb dieser Funktion definiert hätten. - Aus diesem Grund hat dieser Code den Geltungsbereich der Variablen - dieser Funktion. + Steht include im aufrufenden Skript innerhalb einer Funktion, verhält sich + der gesamte Code der aufgerufenen Datei genau so, als ob Sie diesen Code + innerhalb dieser Funktion definiert hätten. Aus diesem Grund hat dieser + Code den Geltungsbereich der Variablen dieser Funktion. </simpara> <para> <example> @@ -1164,7 +1279,7 @@ include 'vars.php'; - echo "A $color $fruit"; + echo "Ein $color $fruit"; } /* vars.php ist im Geltungsbereich von foo(), * @@ -1172,8 +1287,8 @@ * NICHT zur Verfügung. $color schon, da wir * * diese Variable als global definiert haben */ -foo(); // A green apple -echo "A $color $fruit"; // A green +foo(); // Ein grüner Apfel +echo "Ein $color $fruit"; // Ein grüner ?> ]]> @@ -1215,11 +1330,11 @@ * 'Funkt' hier, dass die Variablen $foo und $bar innerhalb der * * angeforderten Datei zur Verfügung stehen */ -// Funkt. nicht; file.txt wird von www.example.com nicht als PHP geparst +// Funkt nicht; file.txt wird von www.example.com nicht als PHP geparst include 'http://www.example.com/file.txt?foo=1&bar=2'; -// Funkt. nicht; schaut nach einer lokalen Datei namens +// Funkt nicht; schaut nach einer lokalen Datei namens // 'file.php?foo=1&bar=2' im lokalen Dateisystem include 'file.php?foo=1&bar=2'; @@ -1229,17 +1344,16 @@ $foo = 1; $bar = 2; -include 'file.txt'; // Funkt. -include 'file.php'; // Funkt. +include 'file.txt'; // Funkt +include 'file.php'; // Funkt ?> ]]> </programlisting> </example> Siehe auch <link linkend="features.remote-files"> - Zugriff auf entfernte Dateien</link>, - <function>fopen</function> und <function>file</function> für verwandte - Informationen + Zugriff auf entfernte Dateien</link>, <function>fopen</function> und + <function>file</function> für verwandte Informationen. </para> <para> Da <function>include</function> und <function>require</function> @@ -1286,7 +1400,7 @@ <note> <simpara> In PHP 3 darf eine return-Anweisung nicht innerhalb eines Blocks - auftreten, es sei denn, es ist ein Funktions-Block. In diesem Fall gilt + auftreten, es sei denn, es ist ein Funktionsblock. In diesem Fall gilt <function>return</function> für diese Funktion und nicht für die ganze Datei. </simpara> @@ -1332,13 +1446,15 @@ <literal>$bar</literal> hat den Wert <literal>1</literal>, weil include erfolgreich war. Beachten Sie die Unterschiede in den obigen Beispielen. Das erste nutzt <function>return</function> innerhalb der eingebundenen - Datei im Gensatzt zum zweiten Beispiel. - Weitere Möglichkeiten Dateien in Variablen "einzubinden" bieten ihnen die - Funktionen <function>fopen</function> und <function>file</function> oder + Datei im Gegensatz zum zweiten Beispiel. Weitere Möglichkeiten Dateien in + Variablen "einzubinden" bieten ihnen die Funktionen + <function>fopen</function> und <function>file</function> oder <function>include</function> im Zusammenspiel mit den <link linkend="ref.outcontrol">Funktionen zur Ausgabesteuerung</link>. </simpara> + ¬e.language-construct; + <simpara> Siehe auch <function>require</function>, <function>require_once</function>, <function>include_once</function>, <function>readfile</function>, @@ -1350,9 +1466,9 @@ <sect1 id="function.require-once"> <title><function>require_once</function></title> <para> - Die <function>require_once</function>-Anweisung bindet eine Datei ein - und führt diese zur Laufzeit des Skripts aus. - Das Verhalten ist ähnlich der <function>require</function>-Anweisung mit + Die <function>require_once</function> Anweisung bindet eine Datei ein + und wertet diese zur Laufzeit des Skripts aus. + Das Verhalten ist ähnlich der <function>require</function> Anweisung mit dem einzigen Unterschied, dass einmal eingebundener Code aus einer Datei nicht nocht einmal eingebunden wird. Lesen Sie die Dokumentation zu <function>require</function> um mehr Informationen über die Arbeitsweise @@ -1370,7 +1486,7 @@ Weitere Beispiele zu <function>require_once</function> und <function>include_once</function> können Sie dem <ulink url="&url.php.pear;">PEAR</ulink>-Code entnehmen, welcher - im aktuellsten PHP-Source-Code enthalten ist. + im aktuellsten PHP-Sourcecode enthalten ist. </para> <note> <para> @@ -1386,11 +1502,16 @@ <function>include_once</function> nicht unbedingt ihren Erwartungen entspricht. <example> - <title><function>require_once</function> und Groß-/Kleinschreibung</title> + <title> + <function>require_once</function> unterscheidet nicht zwischen + Groß-/Kleinschreibung unter Windows + </title> <programlisting role="php"> <![CDATA[ +<?php require_once("a.php"); // bindet a.php ein require_once("A.php"); // bindet a.php auf Windows nochmal ein! +?> ]]> </programlisting> </example> @@ -1414,7 +1535,7 @@ Ausführungszeit die angegebene Datei ein und wertet diese aus. Dies ist ähnlich der <function>include</function>-Anweisung; mit dem Unterschied, dass einmal eingebundener Code nicht nochmals - eingebunden wird. Wie der Name vermuten lässt, wird ie Datei nur ein + eingebunden wird. Wie der Name vermuten lässt, wird die Datei nur ein einziges Mal eingebunden. </para> <para> @@ -1422,7 +1543,7 @@ wenn die gleiche Datei in einem bestimmten Bereich mehrmals eingebunden und interpretiert werden soll und Sie sicher stellen wollen, dass diese Datei nur exakt einmal eingebunden wird, um Probleme mit Wiederholungen - bei Funktions-Definitionen und Wertzuweisungen zu Variablen zu vermeiden, + von Funktionsdefinitionen und Wertzuweisungen an Variablen zu vermeiden, usw. </para> <para> @@ -1445,11 +1566,16 @@ <function>require_once</function> nicht unbedingt ihren Erwartungen entspricht. <example> - <title><function>include_once</function> und Groß-/Kleinschreibung</title> + <title> + <function>include_once</function> unterscheidet nicht zwischen + Groß-/Kleinschreibung unter Windows + </title> <programlisting role="php"> <![CDATA[ +<?php include_once("a.php"); // bindet a.php ein include_once("A.php"); // bindet a.php auf Windows nochmal ein! +?> ]]> </programlisting> </example>
Index: phpdoc-de/language/control-structures.xml diff -u phpdoc-de/language/control-structures.xml:1.34 phpdoc-de/language/control-structures.xml:1.35 --- phpdoc-de/language/control-structures.xml:1.34 Sat Aug 16 09:09:07 2003 +++ phpdoc-de/language/control-structures.xml Sat Jan 17 15:31:02 2004 @@ -1,30 +1,28 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.34 $ --> -<!-- EN-Revision: 1.66 Maintainer: betz Status: ready --> +<!-- $Revision: 1.35 $ --> +<!-- EN-Revision: 1.85 Maintainer: betz Status: ready --> <!-- CREDITS: tzwenny --> <chapter id="control-structures"> <title>Kontroll-Strukturen</title> <simpara> - Jedes PHP-Skript besteht aus einer Reihe von Anweisungen. Eine - Anweisung kann aus einem Funktionsaufruf, einer Schleife, einer - bedingten Anweisung oder einem Befehl, der nichts macht (eine - leere Anweisung), bestehen. Jede Anweisung endet gewöhnlich mit - einem Semikolon. Darüber hinaus können Anweisungen zu einer - Anweisungsgruppe zusammengefasst werden, welche durch geschweifte - Klammern begrenzt wird. Eine Anweisungsgruppe ist auch eine - Anweisung. Die unterschiedlichen Arten von Anweisungen werden in - diesem Abschnitt erläutert. + Jedes PHP-Skript besteht aus einer Reihe von Anweisungen. Eine Anweisung + kann eine Zuweisung, ein Funktionsaufruf, eine Schleife, eine bedingte + Anweisung oder ein Befehl sein, der nichts macht (eine leere Anweisung). + Jede Anweisung endet gewöhnlich mit einem Semikolon. Darüber hinaus können Anweisungen zu einer + Anweisungsgruppe zusammengefasst werden, welche durch geschweifte Klammern + begrenzt wird. Eine Anweisungsgruppe selbst ist auch wieder eine Anweisung. + Die unterschiedlichen Arten von Anweisungen werden in diesem Kapitel + erläutert. </simpara> <sect1 id="control-structures.if"> <title><literal>if</literal></title> <para> - Das <literal>if</literal>-Konstrukt ist eine der wichtigsten - Möglichkeiten vieler Programmier-Sprachen, PHP eingeschlossen. - Es erlaubt die bedingte Ausführung von Programmteilen. PHP - kennt eine <literal>if</literal>-Struktur, die ähnlich der - Programmiersprache C ist: + Das <literal>if</literal>-Konstrukt ist eine der wichtigsten Möglichkeiten + vieler Programmier-Sprachen, PHP eingeschlossen. Es erlaubt die bedingte + Ausführung von Programmteilen. PHP kennt eine <literal>if</literal> + -Struktur, die ähnlich wie in der Programmiersprache C implementiert ist: <informalexample> <programlisting> <![CDATA[ @@ -36,23 +34,26 @@ </para> <simpara> Wie im Abschnitt über - <link linkend="language.expressions">Ausdrücke</link> beschrieben, wird - <replaceable>ausdr</replaceable> auf seinen boolschen Wertinhalt + <link linkend="language.expressions">Ausdrücke</link> beschrieben, + wird <replaceable>ausdr</replaceable> auf seinen boolschen Wertinhalt ausgewertet. Wenn <replaceable>ausdr</replaceable> als &true; ausgewertet - wird, führt PHP die <replaceable>Anweisung</replaceable> aus, falls die - Auswertung &false; ergibt, wird sie übergangen. Mehr Informationen welche - Werte als &false; ausgewertet werden finden Sie im Abschnitt + wird, führt PHP die <replaceable>Anweisung</replaceable> aus. Falls die + Auswertung &false; ergibt, wird die <replaceable>Anweisung</replaceable> + übergangen. Mehr Informationen drüber welche Werte als &false; ausgewertet + werden finden Sie im Abschnitt <link linkend="language.types.boolean.casting">'Umwandlung nach boolean'</link>. </simpara> <para> Das folgende Beispiel wird <computeroutput>a ist größer als b - </computeroutput>anzeigen, wenn <replaceable>$a</replaceable> - größer als <replaceable>$b</replaceable> ist: + </computeroutput>anzeigen, wenn <replaceable>$a</replaceable> größer als + <replaceable>$b</replaceable> ist: <informalexample> <programlisting role="php"> <![CDATA[ +<?php if ($a > $b) - print "a ist größer als b"; + echo "a ist größer als b"; +?> ]]> </programlisting> </informalexample> @@ -62,25 +63,27 @@ Anweisung wollen. Selbstverständlich ist es nicht erforderlich, jede Anweisung mit einer <literal>if</literal>-Bedingung zu versehen. Statt dessen können Sie mehrere Anweisungen in Gruppen - zusammenfassen. Z.B. wird der folgende Programm-Code + zusammenfassen. Der folgende Programm-Code wird zum Beispiel <computeroutput>a ist größer als b</computeroutput> anzeigen, wenn <replaceable>$a</replaceable> größer als - <replaceable>$b</replaceable> ist. Danach wird der Wert von + <replaceable>$b</replaceable> ist und danach wird der Wert von <replaceable>$a</replaceable> in <replaceable>$b</replaceable> gespeichert: <informalexample> <programlisting role="php"> <![CDATA[ +<?php if ($a > $b) { print "a ist größer als b"; $b = $a; } +?> ]]> </programlisting> </informalexample> </para> <simpara> - <literal>If</literal>-Anweisungen können beliebig oft innerhalb anderer + <literal>if</literal>-Anweisungen können beliebig oft innerhalb anderer <literal>if</literal>-Anweisungen definiert werden. Das ermöglicht ihnen völlige Flexibilität bei der bedingten Ausführung verschiedenster Programmteile. @@ -90,25 +93,26 @@ <sect1 id="control-structures.else"> <title><literal>else</literal></title> <para> - Häufig ist es erforderlich, eine Anweisung auszuführen, wenn eine + Häufig möchten Sie eine Anweisung auszuführen, wenn eine bestimmte Bedingung erfüllt ist und eine andere Anweisung, falls sie nicht erfüllt ist. Dafür gibt es <literal>else</literal>. - <literal>Else</literal> erweitert eine - <literal>if</literal>-Anweisung um die Ausführung von Anweisungen, - sobald der Ausdruck der <literal>if</literal>-Anweisung als - &false; ausgewertet wird. Der folgende Code wird z.B. - <computeroutput>a ist größer als b</computeroutput> anzeigen, - wenn <replaceable>$a</replaceable> größer ist als - <replaceable>$b</replaceable>, anderenfalls + <literal>else</literal> erweitert eine <literal>if</literal>-Anweisung um + die Ausführung von Anweisungen, sobald der Ausdruck der + <literal>if</literal>-Anweisung als &false; ausgewertet wird. Der folgende + Code wird z.B. <computeroutput>a ist größer als b</computeroutput> + ausgeben, wenn <replaceable>$a</replaceable> größer als + <replaceable>$b</replaceable> ist, anderenfalls <computeroutput>a ist NICHT größer als b</computeroutput>: <informalexample> <programlisting role="php"> <![CDATA[ +<?php if ($a > $b) { print "a ist größer als b"; } else { print "a ist NICHT größer als b"; } +?> ]]> </programlisting> </informalexample> @@ -124,29 +128,29 @@ <sect1 id="control-structures.elseif"> <title><literal>elseif</literal></title> <para> - <literal>Elseif</literal> ist, wie der Name schon sagt, eine + Wie der Name schon sagt ist <literal>elseif</literal> eine Verbindung von <literal>if</literal> und <literal>else</literal>. Wie <literal>else</literal> erweitert sie eine - <literal>if</literal>-Anweisung um die Ausführung anderer - Anweisungen, sobald die normale <literal>if</literal>-Bedingung - als &false; angesehen wird. Anders als bei - <literal>else</literal> wird die Ausführung dieser alternativen - Anweisungen nur durchgeführt, wenn die bei - <literal>elseif</literal> angegebene alternative Bedingung als - &true; angesehen wird. Der folgende Code wird - z.B. <computeroutput>a ist größer als b</computeroutput>, + <literal>if</literal>-Anweisung um die Ausführung anderer Anweisungen, + sobald die normale <literal>if</literal>-Bedingung als &false; ausgewertet + wird. Anders als bei <literal>else</literal> wird die Ausführung dieser alternativen + Anweisungen nur durchgeführt, wenn die bei <literal>elseif</literal> + angegebene alternative Bedingung als &true; ausgewertet wird. Der folgende + Code wird z.B. <computeroutput>a ist größer als b</computeroutput>, <computeroutput>a ist gleich b</computeroutput> oder <computeroutput>a ist kleiner als b</computeroutput> ausgeben: <informalexample> <programlisting role="php"> <![CDATA[ +<?php if ($a > $b) { - print "a ist größer als b"; + echo "a ist größer als b"; } elseif ($a == $b) { - print "a ist gleich b"; + echo "a ist gleich b"; } else { - print "a ist kleiner als b"; + echo "a ist kleiner als b"; } +?> ]]> </programlisting> </informalexample> @@ -154,32 +158,29 @@ <simpara> Es kann mehrere <literal>elseif</literal>-Anweisungen innerhalb einer <literal>if</literal>-Anweisung geben. Die erste - <literal>elseif</literal>-Bedingung (falls vorhanden), die - &true; ist, wird ausgeführt. In PHP kann man - auch 'else if' schreiben (zwei Wörter). Das Verhalten ist - identisch zu 'elseif' (ein Wort). Die Bedeutung der Syntax ist leicht - unterschiedlich (falls Sie mit C vertraut sind, das ist das gleiche - Verhalten) aber der Grundtenor ist der, dass beide Schreibweisen, bezogen - auf das Ergebnis, sich exakt gleich verhalten. + <literal>elseif</literal>-Bedingung (falls vorhanden), die &true; ist, + wird ausgeführt. In PHP kann man auch 'else if' schreiben (zwei Wörter). + Das Verhalten ist identisch zu 'elseif' (ein Wort). Die Bedeutung der + Syntax ist leicht unterschiedlich (falls Sie mit C vertraut sind, das ist + das gleiche Verhalten) aber der Grundtenor ist der, dass beide + Schreibweisen, bezogen auf das Ergebnis, sich exakt gleich verhalten. </simpara> <simpara> - Die <literal>elseif</literal>-Anweisung wird nur ausgeführt, - wenn die vorausgehende <literal>if</literal>-Bedingung sowie - jede vorherige <literal>elseif</literal>-Bedingung - &false; ist und die aktuelle - <literal>elseif</literal>-Bedingung &true; ist. + Die <literal>elseif</literal>-Anweisung wird nur ausgeführt, wenn die + vorausgehende <literal>if</literal>-Bedingung sowie jede vorherige + <literal>elseif</literal>-Bedingung als &false; ausgewertet wird und die + aktuelle <literal>elseif</literal>-Bedingung &true; ist. </simpara> </sect1> <sect1 id="control-structures.alternative-syntax"> <title>Alternative Syntax für Kontroll-Strukturen</title> <para> - PHP bietet eine alternative Syntax für einige seiner - Kontroll-Strukturen, als da sind <literal>if</literal>, - <literal>while</literal>, <literal>for</literal>, - <literal>foreach</literal> und <literal>switch</literal>. - Immer muss die öffnende Klammer durch einen Doppelpunkt - ":" und die schließende Klammer durch ein + PHP bietet eine alternative Syntax für einige seiner Kontroll-Strukturen, + als da sind <literal>if</literal>, <literal>while</literal>, + <literal>for</literal>, <literal>foreach</literal> und + <literal>switch</literal>. Die öffnende Klammer muss immer durch einen + Doppelpunkt ":" und die schließende Klammer entsprechend durch <literal>endif;</literal>, <literal>endwhile;</literal>, <literal>endfor;</literal>, <literal>endforeach;</literal> oder <literal>endswitch;</literal> ersetzt werden. @@ -187,7 +188,7 @@ <programlisting role="php"> <![CDATA[ <?php if ($a == 5): ?> - A ist gleich 5 +A ist gleich 5 <?php endif; ?> ]]> </programlisting> @@ -195,26 +196,28 @@ </para> <simpara> Im obigen Beispiel ist der HTML-Bereich "A ist gleich 5" in eine - <literal>if</literal>-Anweisung mit alternativer Syntax eingebettet. - Der HTML-Bereich wird nur ausgegeben, wenn $a gleich 5 ist. + <literal>if</literal>-Anweisung mit alternativer Syntax eingebettet. Der + HTML-Bereich wird nur ausgegeben, wenn $a gleich 5 ist. </simpara> <para> - Die alternative Syntax kann auch auf <literal>else</literal> - und <literal>elseif</literal> angewendet werden. Es folgt eine + Die alternative Syntax kann auch auf <literal>else</literal> und + <literal>elseif</literal> angewendet werden. Es folgt eine <literal>if</literal>-Struktur mit <literal>elseif</literal> und <literal>else</literal> im alternativen Format: <informalexample> <programlisting role="php"> <![CDATA[ +<?php if ($a == 5): - print "a ist gleich 5"; - print "..."; + echo "a ist gleich 5"; + echo "..."; elseif ($a == 6): - print "a ist gleich 6"; - print "!!!"; + echo "a ist gleich 6"; + echo "!!!"; else: - print "a ist weder 5 noch 6"; + echo "a ist weder 5 noch 6"; endif; +?> ]]> </programlisting> </informalexample> @@ -229,9 +232,9 @@ <sect1 id="control-structures.while"> <title><literal>while</literal></title> <para> - <literal>While</literal>-Schleifen sind die einfachste Form von - Schleifen in PHP. Sie funktionieren genau wie in C. Die - Grundform einer <literal>while</literal>-Anweisung lautet: + Die <literal>while</literal>-Schleifen sind die einfachste Form von + Schleifen in PHP. Sie funktionieren genau wie in C. Die Grundform einer + <literal>while</literal>-Anweisung lautet: <informalexample> <programlisting> <![CDATA[ @@ -249,15 +252,15 @@ innerhalb der <literal>while</literal>-Schleife verändert, endet die Ausführung dieses Anweisungsblocks erst mit dem Ende der Iteration (Jeder Schleifendurchlauf ist eine Iteration). Falls die - <literal>while</literal>-Bedingung bereits zu Beginn &false; ist, werden - die Anweisungen der <literal>while</literal>-Schleife nicht ein einziges - Mal durchlaufen. + <literal>while</literal>-Bedingung bereits beim ersten Mal &false; ist, + werden die Anweisungen der <literal>while</literal>-Schleife nicht ein + einziges Mal durchlaufen. </simpara> <para> - Wie bei der <literal>if</literal>-Anweisung kann man mehrere - Anweisungen innerhalb der gleichen <literal>while</literal>-Schleife angeben, - indem man sie mit geschweiften Klammern umschließt oder die alternative - Syntax gebraucht: + Wie bei der <literal>if</literal>-Anweisung können Sie mehrere + Anweisungen innerhalb der gleichen <literal>while</literal>-Schleife + angeben, indem Sie dieses mit geschweiften Klammern umschließen oder die + alternative Syntax verwenden: <informalexample> <programlisting> <![CDATA[ @@ -276,16 +279,15 @@ $i = 1; while ($i <= 10) { - print $i++; /* es wird erst $i ausgegeben, - bevor der Wert erhöht wird - (Post-Inkrement) */ + echo $i++; /* es wird erst $i ausgegeben, bevor der Wert erhöht wird + (Post-Inkrement) */ } /* Beispiel 2 */ $i = 1; while ($i <= 10): - print $i; + echo $i; $i++; endwhile; ]]> @@ -296,59 +298,61 @@ <sect1 id="control-structures.do.while"> <title><literal>do..while</literal></title> <simpara> - <literal>Do..while</literal>-Schleifen sind den <literal>while</literal> - -Schleifen sehr ähnlich, außer dass der Wahrheitsgehalt des Ausdrucks erst am - Ende jedes Durchlaufs geprüft wird, statt am Anfang. Der Hauptunterschied + <literal>do..while</literal>-Schleifen sind den <literal>while</literal> + -Schleifen sehr ähnlich, außer dass der Wahrheitsgehalt des Ausdrucks erst + am Ende jedes Durchlaufs geprüft wird, statt am Anfang. Der Hauptunterschied zu gewöhnlichen <literal>while</literal>-Schleifen ist der, dass die Schleife bei <literal>do..while</literal> in jeden Fall einmal durchlaufen wird - (die Bedingung wird erst am Ende einer Iteration geprüft), - wogegen es bei <literal>while</literal>-Schleifen - durchaus passieren kann, dass die Schleife nie durchlaufen wird (die - Bedingung wird immer am Anfang eines Durchlaufs überprüft. Wird diese - Bedingung von Anfang an als &false; ausgewertet endet die Ausführung - der Schleife sofort). + (die Bedingung wird erst am Ende eines Durchlaufs geprüft).Bei + <literal>while</literal>-Schleifen hingegen kann es durchaus passieren, + dass die Schleife nie durchlaufen wird (die Bedingung wird immer am Anfang + eines Durchlaufs überprüft. Wird diese Bedingung von Anfang an als &false; + ausgewertet endet die Ausführung der Schleife sofort). </simpara> <para> Es gibt nur eine Syntax für <literal>do..while</literal>-Schleifen: <informalexample> <programlisting role="php"> <![CDATA[ +<?php $i = 0; do { - print $i; + echo $i; } while ($i>0); +?> ]]> </programlisting> </informalexample> </para> <simpara> Die obige Schleife wird genau einmal durchlaufen, da nach der - ersten Wiederholung die Erfüllung der Bedingung geprüft wird. Da - diese aber nicht erfüllt, also &false; ist ($i ist nicht größer als 0), - wird die Schleifenausführung beendet. + ersten Wiederholung die Erfüllung der Bedingung geprüft wird. Diese + Bedingung ist aber nicht erfüllt ($i ist nicht größer als 0), wird als + &false; ausgewertet, und die Schleifenausführung beendet. </simpara> <para> Erfahrene C-Anwender kennen auch die Möglichkeit, Programm-Blöcke - mit <literal>do..while</literal>(0) einzuschliessen und dann die + mit <literal>do..while</literal> (0) einzuschliessen und dann die <link linkend="control-structures.break"><literal>break</literal></link> - Anweisung zu benutzen. Der folgende Programm-Ausschnitt zeigt dies: + Anweisung zu benutzen. Der folgende Programm-Ausschnitt zeigt diese + Möglichkeit: <informalexample> <programlisting role="php"> <![CDATA[ do { if ($i < 5) { - print "i ist nicht groß genug"; + echo "i ist nicht groß genug"; break; } $i *= $factor; if ($i < $minimum_limit) { break; } - print "i ist ok"; + echo "i ist ok"; - ...bearbeite i... + /* mach was mit i */ -} while(0); +} while (0); ]]> </programlisting> </informalexample> @@ -363,9 +367,9 @@ <sect1 id="control-structures.for"> <title><literal>for</literal></title> <para> - <literal>For</literal>-Schleifen sind die komplexesten Schleifen - in PHP. Sie funktionieren wie ihr Gegenstück in C. Die Syntax - einer <literal>for</literal>-Schleife sieht so aus: + Die <literal>for</literal>-Schleifen sind die komplexesten Schleifen in + PHP. Sie funktionieren wie ihr Gegenstück in C. Die Syntax einer + <literal>for</literal>-Schleife sieht wie folgt aus: <informalexample> <programlisting> <![CDATA[ @@ -380,20 +384,19 @@ </simpara> <simpara> Zu Beginn jedes Durchlaufs wird nun <replaceable>ausdr2</replaceable> - geprüft. Wenn dieser &true; ist, fährt die Schleife - fort mit der Ausführung der nachfolgenden Anweisung. Ist das - Ergebnis &false;, wird die Schleife beendet. + geprüft. Wenn dieser &true; ist, fährt die Schleife mit der Ausführung der + nachfolgenden Anweisung(en) fort. Ist das Ergebnis &false;, wird die + Schleife beendet. </simpara> <simpara> Am Ende jedes Durchlaufs wird <replaceable>ausdr3</replaceable> geprüft (ausgeführt). </simpara> <simpara> - Jeder Ausdruck kann leer sein. - Ist <replaceable>ausdr2</replaceable> leer, wird die Schleife endlos oft - durchlaufen (PHP wertet diesen, wie in C, implizit als &true;). Das ist - nicht so sinnlos, wie Sie vielleicht glauben, weil man häufig eine - Schleife erst durch eine bedingte + Jeder Ausdruck kann leer sein. Ist <replaceable>ausdr2</replaceable> leer, + wird die Schleife endlos oft durchlaufen (PHP wertet diesen, wie in C, + implizit als &true;). Das ist gar nicht so sinnlos, wie Sie vielleicht + zunächst glauben, weil man häufig eine Schleife erst durch eine bedingte <link linkend="control-structures.break"><literal>break</literal> </link>-Anweisung statt durch eine unwahr werdende <literal>for</literal>-Bedingung beenden möchte. @@ -404,44 +407,46 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php /* Beispiel 1 */ - + for ($i = 1; $i <= 10; $i++) { - print $i; + echo $i; } - + /* Beispiel 2 */ -for ($i = 1;;$i++) { +for ($i = 1; ; $i++) { if ($i > 10) { break; } - print $i; + echo $i; } /* Beispiel 3 */ - + $i = 1; -for (;;) { +for (; ; ) { if ($i > 10) { break; } - print $i; + echo $i; $i++; } /* Beispiel 4 */ - -for ($i = 1; $i <= 10; print $i, $i++) ; + +for ($i = 1; $i <= 10; echo $i, $i++); +?> ]]> </programlisting> </informalexample> </para> <simpara> - Selbstverständlich sieht das erste (oder vielleicht das vierte) Beispiel am - besten aus, aber Sie werden noch feststellen, dass es oftmals ganz - nützlich sein kann, leere Parameter in - <literal>for</literal>-Schleifen zu verwenden. + Selbstverständlich sieht das erste (oder vielleicht das vierte) Beispiel + am besten aus, aber Sie werden noch feststellen, dass es oftmals ganz + nützlich sein kann, leere Parameter in <literal>for</literal>-Schleifen zu + verwenden. </simpara> <para> PHP unterstützt auch bei <literal>for</literal>-Schleifen die @@ -455,14 +460,14 @@ </informalexample> </para> <para> - Andere Sprachen haben für das Durchlaufen eines Hash´s oder - Arrays eine <literal>foreach</literal>-Anweisung. PHP 3 hat dies - nicht; im Gegensatz zu PHP 4 (vgl. + Andere Sprachen haben für das Durchlaufen eines Hashs oder Arrays eine + <literal>foreach</literal>-Anweisung. PHP 3 hat dies nicht; im Gegensatz + zu PHP 4 (vgl. <link linkend="control-structures.foreach">foreach</link>). - In PHP 3 kann man dafür eine Kombination von + In PHP 3 können Sie für diesen Zweck <link linkend="control-structures.while">while</link> mit der <function>list</function>- und <function>each</function>-Funktion - einsetzen. Beispiele finden Sie in der Dokumentation zu diesen + kombinieren. Beispiele finden Sie in der Dokumentation zu diesen Funktionen. </para> </sect1> @@ -474,25 +479,25 @@ genau wie Perl und einige andere Sprachen. Diese ermöglicht es, auf einfache Weise ein Array zu durchlaufen. <literal>foreach</literal> funktioniert nur in Verbindung mit Arrays. Wenn Sie versuchen - <literal>foreach</literal> mit einer Variable eines anderen Datentyps oder - einer nicht initialisierten Variable zu benutzen, gibt PHP einen Fehler - aus. Es gibt zwei Syntax-Formen; die zweite ist eine unbedeutende, aber - sinnvolle Erweiterung der ersten Syntax: + <literal>foreach</literal> mit Variablen eines anderen Datentyps oder + nicht initialisierten Variablen zu benutzen, gibt PHP einen Fehler aus. Es + gibt zwei Syntaxformen; die zweite ist eine unbedeutende, aber sinnvolle + Erweiterung der ersten Syntax: <informalexample> <programlisting> <![CDATA[ -foreach(array_expression as $value) Anweisung -foreach(array_expression as $key => $value) Anweisung +foreach (array_expression as $value) Anweisung +foreach (array_expression as $key => $value) Anweisung ]]> </programlisting> </informalexample> </para> <simpara> - Die erste Form durchläuft das - <literal>array_expression</literal>-Array. Bei jedem Durchgang wird - der Wert des aktuellen Elements <literal>$value</literal> zugewiesen - und der interne Array-Zeiger um eins erhöht. Dadurch wird beim nächsten - Durchgang automatisch das nächste Element ausgewertet. + Die erste Form durchläuft das <literal>array_expression</literal>-Array. + Bei jedem Durchgang wird der Wert des aktuellen Elements + <literal>$value</literal> zugewiesen und der interne Array-Zeiger um eins + erhöht. Dadurch wird beim nächsten Durchgang automatisch das nächste + Element ausgewertet. </simpara> <simpara> Die zweite Form arbeitet genauso, außer dass bei jedem Durchlauf @@ -503,8 +508,8 @@ <note> <para> Sobald <literal>foreach</literal> zum ersten Mal ausgeführt wird, - wird der interne Array-Pointer automatisch auf das erste Element - des Arrays zurück gesetzt. Das bedeutet, dass Sie vor einem Durchlauf + wird der interne Arrayzeiger automatisch auf das erste Element + des Arrays gesetzt. Das bedeutet, dass Sie vor einem Durchlauf von <literal>foreach</literal> <function>reset</function> nicht aufrufen müssen. </para> @@ -515,7 +520,7 @@ <para> Beachten Sie auch, dass <literal>foreach</literal> mit einer Kopie des angegebenen Arrays arbeitet, nicht mit dem Array selbst. - Deshalb wird auch der Array-Pointer nicht wie bei dem + Deshalb wird auch der Arrayzeiger nicht wie bei dem <function>each</function>-Konstrukt verändert und Veränderungen an ausgegebenen Arrayelementen haben keine Auswirkung auf das originale Array. Trotzdem <emphasis>wird</emphasis> der interne Arrayzeiger @@ -527,8 +532,8 @@ </para> <note> <para> - Fehlermeldungen durch den Gebrauch von '@' zu unterdrücken ist bei - <literal>foreach</literal> nicht möglich. + Bei <literal>foreach</literal> ist es nicht möglich Fehlermeldungen durch + den Gebrauch von '@' zu unterdrücken ist </para> </note> <para> @@ -537,13 +542,16 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php +$arr = array("eins", "zwei", "drei"); reset ($arr); while (list(, $value) = each ($arr)) { - echo "Wert: $value<br>\n"; + echo "Wert: $value<br />\n"; } foreach ($arr as $value) { - echo "Wert: $value<br>\n"; + echo "Wert: $value<br />\n"; +?> } ]]> </programlisting> @@ -552,14 +560,17 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php +$arr = array("eins", "zwei", "drei"); reset ($arr); while (list($key, $value) = each ($arr)) { - echo "Schlüssel: $key; Wert: $value<br>\n"; + echo "Schlüssel: $key; Wert: $value<br />\n"; } foreach ($arr as $key => $value) { - echo "Schlüssel: $key; Wert: $value<br>\n"; + echo "Schlüssel: $key; Wert: $value<br />\n"; } +?> ]]> </programlisting> </informalexample> @@ -569,29 +580,30 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php /* foreach Beispiel 1: Nur der Wert */ -$a = array (1, 2, 3, 17); +$a = array(1, 2, 3, 17); foreach ($a as $v) { - print "Aktueller Wert von \$a: $v.\n"; + echo "Aktueller Wert von \$a: $v.\n"; } /* foreach Beispiel 2: -Wert (mit Ausgabe des Array-Schlüssels zur Veranschaulichung) */ +Wert (mit Ausgabe des Arrayschlüssels zur Veranschaulichung) */ -$a = array (1, 2, 3, 17); +$a = array(1, 2, 3, 17); $i = 0; /* nur zu Veranschaulichung */ foreach($a as $v) { - print "\$a[$i] => $v.\n"; + echo "\$a[$i] => $v.\n"; $i++; } /* foreach Beispiel 3: Schlüssel und Wert */ -$a = array ( +$a = array( "eins" => 1, "zwei" => 2, "drei" => 3, @@ -599,7 +611,7 @@ ); foreach($a as $k => $v) { - print "\$a[$k] => $v.\n"; + echo "\$a[$k] => $v.\n"; } /* foreach Beispiel 4: multidimensionale Arrays */ @@ -611,15 +623,16 @@ foreach($a as $v1) { foreach ($v1 as $v2) { - print "$v2\n"; + echo "$v2\n"; } } /* foreach Beispiel 5: dynamische Arrays */ -foreach(array(1, 2, 3, 4, 5) as $v) { - print "$v\n"; +foreach (array(1, 2, 3, 4, 5) as $v) { + echo "$v\n"; } +?> ]]> </programlisting> </informalexample> @@ -631,40 +644,42 @@ <simpara> <literal>Break</literal> bricht die Ausführung der aktuellen <literal>for</literal>, <literal>foreach</literal> - <literal>while</literal>, <literal>do..while</literal> or - <literal>switch</literal> - Anweisungs-Sequenz ab. + <literal>while</literal>, <literal>do..while</literal> Schleife oder einer + <literal>switch</literal> Anweisungssequenz ab. </simpara> <simpara> Einem <literal>break</literal> kann optional ein nummerisches Argument angehängt werden, das die Anzahl der abzubrechenden - Befehls-Sequenzen enthält. + Befehlssequenzen enthält. </simpara> <para> <informalexample> <programlisting role="php"> <![CDATA[ -$arr = array ('eins', 'zwei', 'drei', 'vier', 'stop', 'fünf'); +<?php +$arr = array('eins', 'zwei', 'drei', 'vier', 'stop', 'fünf'); while (list ( , $val) = each ($arr)) { if ($val == 'stop') { - break; /* Man kann hier auch 'break 1;' schreiben. */ + break; /* Sie könnten hier auch 'break 1;' schreiben. */ } - echo "$val<br>\n"; + echo "$val<br />\n"; /* Benutzung des optionalen Argumentes. */ + $i = 0; - while (++$i) { - switch ($i) { - case 5: - echo "Bei 5<br>\n"; - break 1; /* Beendet nur switch. */ - case 10: - echo "Bei 10; quitting<br>\n"; - break 2; /* Beendet switch und while. */ - default: - break; +while (++$i) { + switch ($i) { + case 5: + echo "Bei 5<br />\n"; + break 1; /* Beendet nur switch. */ + case 10: + echo "Bei 10; aussteigen<br />\n"; + break 2; /* Beendet switch und while. */ + default: + break; } } +?> ]]> </programlisting> </informalexample> @@ -674,21 +689,30 @@ <sect1 id="control-structures.continue"> <title><literal>continue</literal></title> <simpara> - <literal>Continue</literal> wird innerhalb von Schleifen - gebraucht. Die Schleife wird an der aktuellen Stelle abgebrochen - und es wird der nächste Durchlauf begonnen. + <literal>continue</literal> wird innerhalb von Schleifen verwendet. Die + Schleife wird an der aktuellen Stelle abgebrochen und es wird der nächste + Durchlauf begonnen. </simpara> + <note> + <simpara> + Beachten Sie, dass in PHP die + <link linkend="control-structures.switch">switch</link> Anweisung + als Schleifenstruktur zum Zweck von <literal>continue</literal> angesehen + wird. + </simpara> + </note> <simpara> - <literal>Continue</literal> kann optional ein nummerisches - Argument erhalten, das angibt, wie viele Ebenen von enhaltenen Schleifen + Bei <literal>continue</literal> können Sie ein optionales nummerisches + Argument mitgeben, das angibt, wie viele Ebenen von enhaltenen Schleifen übersprungen werden sollen. </simpara> <para> <informalexample> <programlisting role="php"> <![CDATA[ +<?php while (list ($key, $value) = each ($arr)) { - if ($key % 2) { // überspringe ungerade Werte + if (!($key % 2)) { // überspringe ungerade Werte continue; } tue_was_mit_ungerade ($value); @@ -696,23 +720,68 @@ $i = 0; while ($i++ < 5) { - echo "Außn<br>\n"; + echo "Außen<br />\n"; while (1) { - echo " Mitte<br>\n"; + echo " Mitte<br />\n"; while (1) { - echo " Innen<br>\n"; + echo " Innen<br />\n"; continue 3; } - echo "Das wird nie ausgegeben.<br>\n"; + echo "Das wird nie ausgegeben.<br />\n"; } - echo "Dies auch nicht.<br>\n"; + echo "Das hier auch nicht.<br />\n"; } +?> ]]> </programlisting> </informalexample> </para> + <para> + Lassen Sie das Semikolon nach <literal>continue</literal> weg, kann dies + zu verwirrenden Ergebnissen führen. Es folgt ein Beispiel wie Sie es + nicht machen sollten. + </para> + <para> + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php + for ($i = 0; $i < 5; ++$i) { + if ($i == 2) + continue + print "$i\n"; + } +?> +]]> + </programlisting> + <para> + Sie könnten erwarten, dass das Ergebnis wie folgt aussieht, + </para> + <screen> +<![CDATA[ +0 +1 +3 +4 +]]> + </screen> + <para> + aber tatsächlich sieht die Ausgabe so aus, + </para> + <screen> +<![CDATA[ +2 +]]> + </screen> + <para> + weil der Rückgabewert von <function>print</function> + <literal>int(1)</literal> ist und das wird als das oben angesprochene + optinale Argument gewertet. + </para> + </informalexample> + </para> </sect1> - + <sect1 id="control-structures.switch"> <title><literal>switch</literal></title> <simpara> @@ -722,135 +791,148 @@ mit verschiedensten Werten vergleichen und in Abhängigkeit vom Auswertungsergebnis verschiedene Programmteile ausführen. Genau das ermöglicht die <literal>switch</literal>-Anweisung. - </simpara> + </simpara> + <note> + <simpara> + Beachten Sie bitte, dass im Unterschied zu anderen Programmiersprachen + die <link linkend="control-structures.continue">continue</link> + Anweisung auch bei switch ihre Gültigkeit hat und ähnlich wie + <literal>break</literal> funktioniert. Falls Sie switch innerhalb einer + Schleife verwenden und mit dem nächsten Durchlauf der äußeren Schleife + beginnen möchten, verwenden Sie <literal>continue 2</literal>. + </simpara> + </note> <para> - Die folgenden zwei Beispiele zeigen zwei verschiedene Wege, das Gleiche - zu bewirken; eines gebraucht mehrere <literal>if</literal>-Anweisungen, - das andere eine <literal>switch</literal>-Anweisung: + Das folgende Beispiele zeigt Ihnen zwei verschiedene Möglichkeiten auf, + das Gleiche zu erreichen. Einmal werden <literal>if</literal> und + <literal>elseif</literal> Anweisungen benutzt, das andere Mal eine + <literal>switch</literal>-Anweisung: <informalexample> <programlisting role="php"> <![CDATA[ +<?php if ($i == 0) { - print "i ist gleich 0"; + echo "i ist gleich 0"; +} elseif ($i == 1) { + echo "i ist gleich 1"; +} elseif ($i == 2) { + echo "i ist gleich 2"; } -if ($i == 1) { - print "i ist gleich 1"; -} -if ($i == 2) { - print "i ist gleich 2"; -} - + switch ($i) { - case 0: - print "i ist gleich 0"; - break; - case 1: - print "i ist gleich 1"; - break; - case 2: - print "i ist gleich 2"; - break; +case 0: + echo "i ist gleich 0"; + break; +case 1: + echo "i ist gleich 1"; + break; +case 2: + echo "i ist gleich 2"; + break; } +?> ]]> </programlisting> </informalexample> </para> <para> - Es ist wichtig, die Ausführung einer - <literal>switch</literal>-Anweisung zu verstehen, um Fehler zu - vermeiden. Die <literal>switch</literal>-Anweisung wird Zeile für - Zeile (also Anweisung für Anweisung) abgearbeitet. Zu Beginn wird - nichts ausgeführt. Erst wenn bei einem <literal>case</literal>-Teil - eine Entsprechung zum <literal>switch</literal>-Ausdruck vorliegt, - werden die darin enthaltenen Anweisungen von PHP ausgeführt. PHP fährt - dann mit der Abarbeitung des restlichen Codes innerhalb des - <literal>switch</literal>-Blocks fort oder bis zum ersten - Auftreten einer <literal>break</literal>-Anweisung. Ohne + Es ist wichtig, die Ausführung einer <literal>switch</literal>-Anweisung + zu verstehen, um Fehler zu vermeiden. Die <literal>switch</literal>-Anweisung + wird Zeile für Zeile (also Anweisung für Anweisung) abgearbeitet. Zu + Beginn wird kein Code ausgeführt. Erst wenn bei einem + <literal>case</literal>-Teil eine Entsprechung zum + <literal>switch</literal>-Ausdruck vorliegt, werden die darin enthaltenen + Anweisungen von PHP ausgeführt. PHP fährt dann mit der Abarbeitung des + restlichen Codes innerhalb des <literal>switch</literal>-Blocks fort oder + bis zum ersten Auftreten einer <literal>break</literal>-Anweisung. Ohne <literal>break</literal> am Ende eines case-Teils werden also - noch die folgenden case-Blöcke ausgeführt. - Zum Beispiel: + noch die folgenden case-Blöcke ausgeführt. Zum Beispiel: <informalexample> <programlisting role="php"> <![CDATA[ +<?php switch ($i) { - case 0: - print "i ist gleich 0"; - case 1: - print "i ist gleich 1"; - case 2: - print "i ist gleich 2"; +case 0: + echo "i ist gleich 0"; +case 1: + echo "i ist gleich 1"; +case 2: + echo "i ist gleich 2"; } +?> ]]> </programlisting> </informalexample> </para> <simpara> - Wenn hier $i gleich 0 ist, würde PHP alle print-Anweisungen - ausführen! Ist $i gleich 1, werden die letzten beiden - print-Befehle ausgeführt und wenn $i = 2 ist, wird nur der - letzte print-Befehl ausgeführt. Deshalb ist es wichtig - <literal>break</literal>-Anweisungen zu setzen (abgesehen von - bestimmten Fällen, in denen Sie diese mit Absicht weglassen). - </simpara> - <simpara> - Bei einer <literal>switch</literal>-Anweisung wird die - Bedingung also nur einmal überprüft und das Ergebnis mit jeder - <literal>case</literal>-Anweisung verglichen. Bei einem - <literal>elseif</literal>-Befehl wird die Bedingung neu geprüft. - Ist ihre Bedingung komplizierter als ein einfacher Vergleich - und/oder in einer umfangreichen Schleife eingebettet, kann - eine <literal>switch</literal>-Anweisung schneller als - mehrere <literal>if</literal>-Befehle sein. + Wenn hier $i gleich 0 ist, würde PHP alle echo Anweisungen ausführen! Ist + $i gleich 1, werden die letzten beiden echo Anweisungen ausgeführt. Nur + wenn $i = 2 ist, erhalten Sie das erwartete Ergebnis: die Ausgabe von + "i ist gleich 2". Deshalb ist es wichtig <literal>break</literal>-Anweisungen + zu setzen (abgesehen von bestimmten Fällen, in denen Sie diese mit Absicht + weglassen). + </simpara> + <simpara> + Bei einer <literal>switch</literal>-Anweisung wird die Bedingung also nur + einmal überprüft und das Ergebnis mit jeder <literal>case</literal>-Anweisung + verglichen. Bei einer <literal>elseif</literal>-Anweisung wird die + Bedingung neu geprüft. Ist ihre Bedingung komplizierter als ein einfacher + Vergleich und/oder in einer umfangreichen Schleife eingebettet, kann eine + <literal>switch</literal>-Anweisung schneller sein. </simpara> <para> - Der Anweisungsteil von case kann auch leer sein. Dann wird - die Kontrolle einfach an den nächsten case-Teil übergeben. + Der Anweisungsteil von case kann auch leer sein. Dann wird die Kontrolle + einfach an den nächsten case-Teil übergeben. <informalexample> <programlisting role="php"> <![CDATA[ +<?php switch ($i) { - case 0: - case 1: - case 2: - print "i ist kleiner als 3 aber nicht negativ"; - break; - case 3: - print "i ist gleich 3"; +case 0: +case 1: +case 2: + echo "i ist kleiner als 3 aber nicht negativ"; + break; +case 3: + echo "i ist gleich 3"; } +?> ]]> </programlisting> </informalexample> </para> <para> - Ein Spezialfall ist default. Dieser Fall trifft + Ein Spezialfall ist <literal>default</literal>. Dieser Fall trifft auf alles zu, was nicht von den voranstehenden case-Ausdrücken erfasst wurde und sollte als letzte <literal>case</literal> Anweisung angegeben werden. Zum Beispiel: <informalexample> <programlisting role="php"> <![CDATA[ +<?php switch ($i) { - case 0: - print "i ist gleich 0"; - break; - case 1: - print "i ist gleich 1"; - break; - case 2: - print "i ist gleich 2"; - break; - default: - print "i ist weder 0, 1 noch 2"; +case 0: + echo "i ist gleich 0"; + break; +case 1: + echo "i ist gleich 1"; + break; +case 2: + echo "i ist gleich 2"; + break; +default: + echo "i ist weder 0, 1 noch 2"; } +?> ]]> </programlisting> </informalexample> </para> <para> - Der <literal>case</literal>-Ausdruck kann eine Prüfung einfacher - Typen sein, also von Integer- oder Fließkomma-Zahlen oder von - Strings/Zeichenketten. Arrays oder Objekte können nicht benutzt - werden, es sei denn, sie wurden in einfache Typen umgewandelt. + Der <literal>case</literal>-Ausdruck kann eine Prüfung einfacher Typen + sein, also von Integer- oder Fließkomma-Zahlen oder von + Strings/Zeichenketten. Arrays oder Objekte können nicht benutzt werden, es + sei denn, sie wurden in einfache Typen umgewandelt. </para> <para> Die alternative Syntax der Kontrollstrukturen gilt auch für @@ -860,19 +942,21 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php switch ($i): - case 0: - print "i ist gleich 0"; - break; - case 1: - print "i ist gleich 1"; - break; - case 2: - print "i ist gleich 2"; - break; - default: - print "i ist weder 0, 1 noch 2"; +case 0: + echo "i ist gleich 0"; + break; +case 1: + echo "i ist gleich 1"; + break; +case 2: + echo "i ist gleich 2"; + break; +default: + echo "i ist weder 0, 1 noch 2"; endswitch; +?> ]]> </programlisting> </informalexample> @@ -895,9 +979,9 @@ </informalexample> </para> <para> - Die <literal>Directive</literal> gibt Ihnen die Möglichkeit, das + Die <literal>Direktive</literal> gibt Ihnen die Möglichkeit, das Verhalten des <literal>declare</literal>-Blocks zu bestimmen. - Zur Zeit wird nur eine Direktive erkannt: die <literal>ticks</literal> + Zur Zeit wird nur eine Direktive unterstützt: die <literal>ticks</literal> (Weiter unten finden Sie mehr Informationen zu den <link linkend="control-structures.declare.ticks">ticks</link>). </para> @@ -907,6 +991,28 @@ Nebeneffekte während der Ausführung auftreten, hängt von der Direktive ab, die Sie im <literal>directive</literal>-Block angegeben haben. </para> + <para> + Das <literal>declare</literal> Konstrukt kann auch im globalen + Geltungsbereich benutzt werden und gilt dann für den folgenden Code. + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +// bewirkt das Gleiche: + +// sie können declare so benutzen: +declare(ticks=1) { + // hier folgt Ihr ganzes Skript +} + +// oder wie hier: +declare(ticks=1); +// hier folgt Ihr ganzes Skript +?> +]]> + </programlisting> + </informalexample> + </para> <sect2 id="control-structures.declare.ticks"> <title>Ticks</title> @@ -932,7 +1038,7 @@ <![CDATA[ <?php // Funktion, die bei Aufruf die Zeit aufzeichnet -function profile ($dump = FALSE) +function profile($dump = FALSE) { static $profile; @@ -950,18 +1056,18 @@ register_tick_function("profile"); // Funktion vor dem declare-Block initialisieren -profile (); +profile(); // Ausführen eines Code-Blocks, jede 2te Anweisung löst einen tick aus -declare (ticks=2) { +declare(ticks=2) { for ($x = 1; $x < 50; ++$x) { - echo similar_text (md5($x), md5($x*$x)), "<br />;"; + echo similar_text(md5($x), md5($x*$x)), "<br />;"; } } // Ausgabe der gespeicherten Daten aus dem Profiler -print_r (profile (TRUE)); +print_r(profile (TRUE)); ?> ]]> </programlisting> @@ -969,9 +1075,9 @@ Dieses Beispiel 'profiliert' den PHP Code der im 'declare'-Block steht, indem die Zeit festgehalten wird, zu der jede zweite low-level Anweisung im Codeblock ausgeführt wird. Diese Information können Sie dazu benutzen, - langsame Bereiche innerhalb bestimmter Codesegmente zu idebtifizieren. - Das gleiche Ziel können Sie auch mit anderen Methoden erreichen: die - Benutzung von ticks ist bequemer und einfacher zu implementieren. + langsame Bereiche innerhalb bestimmter Codesegmente zu identifizieren. Das + gleiche Ziel können Sie auch mit anderen Methoden erreichen: die Benutzung + von ticks ist bequemer und einfacher zu implementieren. </para> <simpara> Ticks sind gut für Debugging, einfaches Multitasking, @@ -1001,22 +1107,25 @@ aktuelle Skript <function>include</function>ed, wird der Wert, der <function>return</function> zugewiesen wurde, als Wert des Aufrufs von <function>include</function> zurückgegeben. - Wird <function>return</function> inerhalb des Hauptskripts aufgerufen, + Wird <function>return</function> innerhalb des Hauptskripts aufgerufen, wird die Ausführung beendet. Handelt es sich bei dem Skript um eine Datei, die über die Einträge <link linkend="ini.auto-prepend-file">auto_prepend_file</link> oder <link linkend="ini.auto-append-file">auto_append_file</link> - in der <link linkend="configuration.file">Konfigurationsdatei</link> - aufgerufen wurde, wird die Ausführung dieses Skripts beendet. + in der &php.ini; aufgerufen wurde, wird die Ausführung dieses Skripts + beendet. + </simpara> + <simpara>Weitere Informationen erhalten Sie im Abschnitt <link + linkend="functions.returning-values">Rückgabewerte</link>. </simpara> <note> <simpara> Beachten Sie, dass <function>return</function> ein Sprachkonstrukt und - keine Funktion ist. Deshalb brauchen Sie die Klammern um die Argumente - <emphasis>nur</emphasis> dann zu setzen, wenn es sich um einen Ausdruck - handelt, dessen Ergebnis zurückgegeben werden soll. - Es ist gebräuchlich, die Klammern wegzulassen, wenn eine Variable oder - ein Wert dem return-Konstrukt folgt. + keine Funktion ist. Die Klammern um ein Argument sind deshalb + <emphasis>nur</emphasis> zwingend notwendig, wenn es sich um einen + Ausdruck handelt, dessen Ergebnis zurückgegeben werden soll. + Es ist gebräuchlich die Klammern wegzulassen, wenn eine Variable zurück + gegeben soll. </simpara> </note> </sect1> @@ -1024,18 +1133,18 @@ <sect1 id="function.require"> <title><function>require</function></title> <simpara> - Die <function>require</function> Anweisung bindet eine Datei ein und führt - diese aus. + Die <function>require</function> Anweisung bindet die angegebene Datei ein + und wertet diese aus. </simpara> <simpara> - <function>require</function> bindet eine Datei ein und führt + <function>require</function> bindet die angegebene Datei ein und führt diese aus. Genaue Informationen wie die Einbindung funktioniert ist in der Dokumentation für <function>include</function> beschrieben. </simpara> <simpara> - <function>require</function> und <function>include</function> - sind in jeder Hinsicht gleichwertig mit der einen Ausnahme: der - Umgang mit Fehlern. <function>include</function> erzeugt ein + <function>require</function> und <function>include</function> sind in + jeder Hinsicht gleichwertig mit der einen Ausnahme: der Umgang mit + Fehlern. <function>include</function> erzeugt ein <link linkend="internal.e-warning">Warning</link> während <function>require</function> in einem <link linkend="internal.e-error"> Fatal Error</link> endet. Mit anderen Worten: scheuen Sie sich nicht, @@ -1067,22 +1176,29 @@ Weitere Beispiele finden Sie in der Dokumentation zu <function>include</function>. </simpara> - <note> - <simpara> - Für frühere Versionen als PHP 4.0.2 gilt folgendes: - <function>require</function> wird immer versuchen die Zieldatei zu lesen, - selbst wenn die Zeile in der die Anweisung steht, nie ausgeführt wird. Eine - bedingte Anweisung hat keine Auswirkungen auf <function>require</function>. - Wenn jedoch die Zeile in der <function>require</function> steht, nie - ausgeführt wird, wird auch der Code der Zieldatei nie ausgeführt werden. - Ähnliches gilt für Schleifenstrukturen, diese beeinflussen das Verhalten - von <function>require</function> nicht. Obwohl der Code, der in der - Zieldatei enthalten ist, zur Schleife gehört, wird - <function>require</function> selbst nur einmal ausgeführt. - </simpara> - </note> + <para> + <note> + <simpara> + Für frühere Versionen als PHP 4.0.2 gilt folgendes: + <function>require</function> wird immer versuchen die Zieldatei zu lesen, + selbst wenn die Zeile in der die Anweisung steht, nie ausgeführt wird. + Eine bedingte Anweisung hat keine Auswirkungen auf + <function>require</function>. Wenn jedoch die Zeile in der + <function>require</function> steht, nie ausgeführt wird, wird auch der + Code der Zieldatei nie ausgeführt werden. Ähnliches gilt für + Schleifenstrukturen, diese beeinflussen das Verhalten von + <function>require</function> nicht. Obwohl der Code, der in der Zieldatei + enthalten ist, zur Schleife gehört, wird <function>require</function> + selbst nur einmal ausgeführt. + </simpara> + </note> + </para> + + ¬e.language-construct; + &warn.no-win32-fopen-wrapper; - <simpara> + +<simpara> Siehe auch <function>include</function>, <function>require_once</function>, <function>include_once</function>, <function>eval</function>, <function>file</function>, <function>readfile</function>, @@ -1093,8 +1209,8 @@ <sect1 id="function.include"> <title><function>include</function></title> <simpara> - Die <function>include</function>-Anweisung bindet die angegebene Datei - ein und wertet sie aus. + Die <function>include</function> Anweisung bindet die angegebene Datei ein + und wertet diese aus. </simpara> <simpara> Die untenstehende Dokumentation gilt ebenso für @@ -1119,25 +1235,25 @@ </simpara> <para> <example> - <title>Grundlegende <function>include</function> Beispiel</title> + <title>Grundlegendes <function>include</function> Beispiel</title> <programlisting role="php"> <![CDATA[ vars.php <?php -$color = 'green'; -$fruit = 'appel'; +$color = 'grün'; +$fruit = 'Apfel'; ?> test.php <?php -echo "A $color $fruit"; // A +echo "Ein $color $fruit"; // A include 'vars.php'; -echo "A $color $fruit"; // A green apple +echo "Ein $color $fruit"; // Ein grüner Apfel ?> ]]> @@ -1145,11 +1261,10 @@ </example> </para> <simpara> - Steht include im aufrufenden Skript innerhalb einer Funktion, - verhält sich der gesamte Code der aufgerufenen Datei genau so, - als ob Sie diesen Code innerhalb dieser Funktion definiert hätten. - Aus diesem Grund hat dieser Code den Geltungsbereich der Variablen - dieser Funktion. + Steht include im aufrufenden Skript innerhalb einer Funktion, verhält sich + der gesamte Code der aufgerufenen Datei genau so, als ob Sie diesen Code + innerhalb dieser Funktion definiert hätten. Aus diesem Grund hat dieser + Code den Geltungsbereich der Variablen dieser Funktion. </simpara> <para> <example> @@ -1164,7 +1279,7 @@ include 'vars.php'; - echo "A $color $fruit"; + echo "Ein $color $fruit"; } /* vars.php ist im Geltungsbereich von foo(), * @@ -1172,8 +1287,8 @@ * NICHT zur Verfügung. $color schon, da wir * * diese Variable als global definiert haben */ -foo(); // A green apple -echo "A $color $fruit"; // A green +foo(); // Ein grüner Apfel +echo "Ein $color $fruit"; // Ein grüner ?> ]]> @@ -1215,11 +1330,11 @@ * 'Funkt' hier, dass die Variablen $foo und $bar innerhalb der * * angeforderten Datei zur Verfügung stehen */ -// Funkt. nicht; file.txt wird von www.example.com nicht als PHP geparst +// Funkt nicht; file.txt wird von www.example.com nicht als PHP geparst include 'http://www.example.com/file.txt?foo=1&bar=2'; -// Funkt. nicht; schaut nach einer lokalen Datei namens +// Funkt nicht; schaut nach einer lokalen Datei namens // 'file.php?foo=1&bar=2' im lokalen Dateisystem include 'file.php?foo=1&bar=2'; @@ -1229,17 +1344,16 @@ $foo = 1; $bar = 2; -include 'file.txt'; // Funkt. -include 'file.php'; // Funkt. +include 'file.txt'; // Funkt +include 'file.php'; // Funkt ?> ]]> </programlisting> </example> Siehe auch <link linkend="features.remote-files"> - Zugriff auf entfernte Dateien</link>, - <function>fopen</function> und <function>file</function> für verwandte - Informationen + Zugriff auf entfernte Dateien</link>, <function>fopen</function> und + <function>file</function> für verwandte Informationen. </para> <para> Da <function>include</function> und <function>require</function> @@ -1286,7 +1400,7 @@ <note> <simpara> In PHP 3 darf eine return-Anweisung nicht innerhalb eines Blocks - auftreten, es sei denn, es ist ein Funktions-Block. In diesem Fall gilt + auftreten, es sei denn, es ist ein Funktionsblock. In diesem Fall gilt <function>return</function> für diese Funktion und nicht für die ganze Datei. </simpara> @@ -1332,13 +1446,15 @@ <literal>$bar</literal> hat den Wert <literal>1</literal>, weil include erfolgreich war. Beachten Sie die Unterschiede in den obigen Beispielen. Das erste nutzt <function>return</function> innerhalb der eingebundenen - Datei im Gensatzt zum zweiten Beispiel. - Weitere Möglichkeiten Dateien in Variablen "einzubinden" bieten ihnen die - Funktionen <function>fopen</function> und <function>file</function> oder + Datei im Gegensatz zum zweiten Beispiel. Weitere Möglichkeiten Dateien in + Variablen "einzubinden" bieten ihnen die Funktionen + <function>fopen</function> und <function>file</function> oder <function>include</function> im Zusammenspiel mit den <link linkend="ref.outcontrol">Funktionen zur Ausgabesteuerung</link>. </simpara> + ¬e.language-construct; + <simpara> Siehe auch <function>require</function>, <function>require_once</function>, <function>include_once</function>, <function>readfile</function>, @@ -1350,9 +1466,9 @@ <sect1 id="function.require-once"> <title><function>require_once</function></title> <para> - Die <function>require_once</function>-Anweisung bindet eine Datei ein - und führt diese zur Laufzeit des Skripts aus. - Das Verhalten ist ähnlich der <function>require</function>-Anweisung mit + Die <function>require_once</function> Anweisung bindet eine Datei ein + und wertet diese zur Laufzeit des Skripts aus. + Das Verhalten ist ähnlich der <function>require</function> Anweisung mit dem einzigen Unterschied, dass einmal eingebundener Code aus einer Datei nicht nocht einmal eingebunden wird. Lesen Sie die Dokumentation zu <function>require</function> um mehr Informationen über die Arbeitsweise @@ -1370,7 +1486,7 @@ Weitere Beispiele zu <function>require_once</function> und <function>include_once</function> können Sie dem <ulink url="&url.php.pear;">PEAR</ulink>-Code entnehmen, welcher - im aktuellsten PHP-Source-Code enthalten ist. + im aktuellsten PHP-Sourcecode enthalten ist. </para> <note> <para> @@ -1386,11 +1502,16 @@ <function>include_once</function> nicht unbedingt ihren Erwartungen entspricht. <example> - <title><function>require_once</function> und Groß-/Kleinschreibung</title> + <title> + <function>require_once</function> unterscheidet nicht zwischen + Groß-/Kleinschreibung unter Windows + </title> <programlisting role="php"> <![CDATA[ +<?php require_once("a.php"); // bindet a.php ein require_once("A.php"); // bindet a.php auf Windows nochmal ein! +?> ]]> </programlisting> </example> @@ -1414,7 +1535,7 @@ Ausführungszeit die angegebene Datei ein und wertet diese aus. Dies ist ähnlich der <function>include</function>-Anweisung; mit dem Unterschied, dass einmal eingebundener Code nicht nochmals - eingebunden wird. Wie der Name vermuten lässt, wird ie Datei nur ein + eingebunden wird. Wie der Name vermuten lässt, wird die Datei nur ein einziges Mal eingebunden. </para> <para> @@ -1422,7 +1543,7 @@ wenn die gleiche Datei in einem bestimmten Bereich mehrmals eingebunden und interpretiert werden soll und Sie sicher stellen wollen, dass diese Datei nur exakt einmal eingebunden wird, um Probleme mit Wiederholungen - bei Funktions-Definitionen und Wertzuweisungen zu Variablen zu vermeiden, + von Funktionsdefinitionen und Wertzuweisungen an Variablen zu vermeiden, usw. </para> <para> @@ -1445,11 +1566,16 @@ <function>require_once</function> nicht unbedingt ihren Erwartungen entspricht. <example> - <title><function>include_once</function> und Groß-/Kleinschreibung</title> + <title> + <function>include_once</function> unterscheidet nicht zwischen + Groß-/Kleinschreibung unter Windows + </title> <programlisting role="php"> <![CDATA[ +<?php include_once("a.php"); // bindet a.php ein include_once("A.php"); // bindet a.php auf Windows nochmal ein! +?> ]]> </programlisting> </example>