cvs: phpdoc-de / language-snippets.ent /language functions.xml
| From: | Carola 'Sammy' Kummert | Date: | Tue, 17 Jun 2008 12:08:18 +0000 |
| Subject: | cvs: phpdoc-de / language-snippets.ent /language functions.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-2683@lists.php.net to get a copy of this message | ||
sammywg Tue Jun 17 12:08:18 2008 UTC
Modified files:
/phpdoc-de/language functions.xml
/phpdoc-de language-snippets.ent
Log:
typo
http://cvs.php.net/viewvc.cgi/phpdoc-de/language/functions.xml?r1=1.20&r2=1.21&diff_format=u Index: phpdoc-de/language/functions.xml diff -u phpdoc-de/language/functions.xml:1.20 phpdoc-de/language/functions.xml:1.21 --- phpdoc-de/language/functions.xml:1.20 Mon Jun 16 22:50:17 2008 +++ phpdoc-de/language/functions.xml Tue Jun 17 12:08:17 2008 @@ -1,17 +1,18 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.20 $ --> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.21 $ --> <!-- EN-Revision: 1.69 Maintainer: hholzgra Status: ready --> <!-- Credits: tom --> + <chapter xml:id="language.functions" xmlns="http://docbook.org/ns/docbook"> <title>Funktionen</title> <sect1 xml:id="functions.user-defined"> <title>Vom Nutzer definierte Funktionen</title> - + <para> Eine Funktion kann wie folgt definiert werden: </para> - + <para> <example> <title>Pseudokode zur Demonstration der Nutzung von Variablen</title> @@ -28,30 +29,30 @@ </programlisting> </example> </para> - + <simpara> Jeder beliebige korrekte PHP-Code kann in einer Funktion vorkommen, sogar andere Funktionen und <link - linkend="keyword.class">Klassen-</link> Definitionen. + linkend="keyword.class">Klassen</link>-Definitionen. </simpara> <para> - Für Funktionsnamen gelten in PHP die gleichen Regeln wie für - andere Bezeichner. Ein gültiger Funktionsname beginnt mit + Für Funktionsnamen gelten in PHP die gleichen Regeln wie für + andere Bezeichner. Ein gültiger Funktionsname beginnt mit einem Buchstaben oder Unterstrich gefolgt von einer beliebigen - Anzahl von Buchstaben, Ziffern und Unterstrichen. Als - regulärer Ausdruck wird dies so ausgedrückt: + Anzahl von Buchstaben, Ziffern und Unterstrichen. Als + regulärer Ausdruck wird dies so ausgedrückt: <literal>[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*</literal>. </para> &tip.userlandnaming; <simpara> - Es ist nicht erforderlich das Funktionen bereits definiert sein - müssen wenn auf sie verviesen wird, - <emphasis>außer</emphasis> wenn eine Funktion nur bedingt definiert + Es ist nicht erforderlich, dass Funktionen bereits definiert sein + müssen, wenn auf sie verviesen wird, + <emphasis>auÃer</emphasis> wenn eine Funktion nur bedingt definiert wird, wie in den beiden untenstehenden Beispielen gezeigt. </simpara> <para> Wenn eine Funktion nur unter bestimmten Bedingungen definiert wird, - muß die Definition dieser Funktion noch <emphasis>vor</emphasis> + muss die Definition dieser Funktion noch <emphasis>vor</emphasis> deren Aufruf abgearbeitet werden. <example> <title>Bedingte Funktionen</title> @@ -61,20 +62,20 @@ $makefoo = true; -/* Wir können foo() von her aus nicht +/* Wir können foo() von hier aus nicht aufrufen, da sie noch nicht existiert, - aber wir können bar() aufrufen */ + aber wir können bar() aufrufen */ bar(); if ($makefoo) { function foo () { - echo "Ich existiere nicht, bis mich die Programmausführung erreicht hat.\n"; + echo "Ich existiere nicht, bis mich die Programmausführung erreicht hat.\n"; } } -/* Nun können wir foo() sicher aufrufen, +/* Nun können wir foo() sicher aufrufen, da $makefoo als true ausgewertet wurde */ if ($makefoo) foo(); @@ -93,72 +94,71 @@ <programlisting role="php"> <![CDATA[ <?php -function foo() +function foo() { - function bar() + function bar() { echo "Ich existiere nicht, bis foo() aufgerufen wurde.\n"; } } -/* Wir können bar() noch nicht +/* Wir können bar() noch nicht aufrufen, da es nicht existiert */ foo(); -/* Nun können wir auch bar() aufrufen, +/* Nun können wir auch bar() aufrufen, da sie durch die Abarbeitung von - foo() verfügbar gemacht wurde */ + foo() verfügbar gemacht wurde */ bar(); -?> +?> ]]> </programlisting> </example> </para> <para> - Alle Funktionen und Klassen in PHP existieren im globalen Namensraum - - sie können außerhalb von Funktionen aufgerufen werden selbst wenn sie + Alle Funktionen und Klassen in PHP existieren im globalen Namensraum - + sie können auÃerhalb von Funktionen aufgerufen werden, selbst wenn sie innerhalb einer Funktion definiert wurden und umgekehrt. </para> <simpara> - PHP unterstützt weder das Überladen von Funktionen, noch ist es - möglich, zuvor deklarierte Funktionen neu zu definieren oder die - Definition zu löschen. + PHP unterstützt weder das Ãberladen von Funktionen, noch ist es + möglich, zuvor deklarierte Funktionen neu zu definieren oder die + Definition zu löschen. </simpara> <note> <simpara> - Groß- und Kleinschreibung spielt zwar bei Funktionsnamen keine + GroÃ- und Kleinschreibung spielt zwar bei Funktionsnamen keine Rolle, es empfiehlt sich aber trotzdem bei Funktionsaufrufen - die gleiche Schreibweise wie in der Deklaration zu benutzen. + die gleiche Schreibweise wie in der Deklaration zu benutzen. </simpara> </note> <simpara> - PHP 3 unterstützt keine variable Anzahl von Parametern, - obwohl Vorgabewerte für Parameter unterstützt werden + PHP 3 unterstützt keine variable Anzahl von Parametern, + obwohl Vorgabewerte für Parameter unterstützt werden (weitere Informationen finden Sie unter <link linkend="functions.arguments.default">Vorgabewerte - für Parameter</link>). Beginnend mit PHP 4 wird beides - unterstützt, - - Sowohl <link linkend="functions.variable-arg-list">eine - variable Anzahl Parameter</link> als auch + für Parameter</link>). Beginnend mit PHP 4 wird beides + unterstützt. + Sowohl <link linkend="functions.variable-arg-list">eine + variable Anzahl Parameter</link> als auch <link linkend="functions.arguments.default">Vorgabewerte - für Parameter</link> werden in Funktionen unterstützt. - Siehe auch die Funktionsreferenzen für + für Parameter</link> werden in Funktionen unterstützt. + Siehe auch die Funktionsreferenzen für <function>func_num_args</function>, <function>func_get_arg</function> und - <function>func_get_args</function> für weitere Informationen. + <function>func_get_args</function> für weitere Informationen. </simpara> <para> - Es ist in PHP möglich Funktionen rekursiv aufzurufen. + Es ist in PHP möglich, Funktionen rekursiv aufzurufen. Sie sollten aber rekursive Aufrufe mit einer Rekursionstiefe - von mehr als 100-200 vermeiden da diese zu einem Stacküberlauf - und damit zum Programmabbruch führen können. + von mehr als 100-200 vermeiden, da diese zu einem Stacküberlauf + und damit zum Programmabbruch führen können. <example> - <title>Recursive Functionen</title> + <title>Rekursive Funktionen</title> <programlisting role="php"> <![CDATA[ <?php @@ -175,34 +175,34 @@ </example> </para> </sect1> - + <sect1 xml:id="functions.arguments"> <title>Funktionsparameter</title> - + <simpara> - Mit einer Parameterliste kann man Informationen an eine Funktion - übergeben. Die Parameterliste ist eine durch Kommas getrennte - Liste von Ausdrücken. + Mit einer Parameterliste kann man Informationen an eine Funktion + übergeben. Die Parameterliste ist eine durch Kommas getrennte + Liste von Ausdrücken. </simpara> <para> - PHP unterstützt die Weitergabe von Parametern als Werte (das ist + PHP unterstützt die Weitergabe von Parametern als Werte (das ist der Standard), als <link - linkend="functions.arguments.by-reference">Verweise</link>, und + linkend="functions.arguments.by-reference">Verweise</link> und als <link linkend="functions.arguments.default">Vorgabewerte</link>. <link linkend="functions.variable-arg-list">Eine variable Anzahl - von Parametern</link> wird ebenfalls unterstützt, siehe auch die - Funktionsreferenzen für + von Parametern</link> wird ebenfalls unterstützt, siehe auch die + Funktionsreferenzen für <function>func_num_args</function>, <function>func_get_arg</function> und - <function>func_get_args</function> für weitere Informationen. + <function>func_get_args</function> für weitere Informationen. </para> <para> <example> - <title>Arrays an Funktionen übergeben</title> + <title>Arrays an Funktionen übergeben</title> <programlisting role="php"> <![CDATA[ ->?php +<?php function rechne_array($eingabe) { echo "$eingabe[0] + $eingabe[1] = ", $eingabe[0]+$eingabe[1]; @@ -212,27 +212,28 @@ </programlisting> </example> </para> - + <sect2 xml:id="functions.arguments.by-reference"> - <title>Verweise als Parameter übergeben</title> - + <title>Verweise als Parameter übergeben</title> + <simpara> Normalerweise werden den Funktionen Werte als Parameter - übermittelt. Wenn man den Wert dieses Parameters innerhalb der - Funktion ändert, bleibt der Parameter außerhalb der Funktion - unverändert. Wollen Sie aber genau das erreichen, dann müssen - Sie die Parameter als Verweise (Referenzen) übergeben. + übermittelt. Wenn man den Wert dieses Parameters innerhalb der + Funktion ändert, bleibt der Parameter auÃerhalb der Funktion + unverändert. Wollen Sie aber erreichen, dass die Ãnderung auch auÃerhalb + der Funktion sichtbar wird, müssen Sie die Parameter als Verweise + (Referenzen) übergeben. </simpara> - + <para> Wenn eine Funktion einen Parameter generell als Verweis behandeln - soll, setzt man in der Funktionsdefinition ein kaufmännisches Und + soll, setzt man in der Funktionsdefinition ein kaufmännisches Und (&) vor den Parameternamen: </para> <para> <example> - <title>Passing function parameters by reference</title> + <title>Ãbergeben von Funktionsparametern als Verweis</title> <programlisting role="php"> <![CDATA[ <?php @@ -250,14 +251,14 @@ </para> </sect2> - + <sect2 xml:id="functions.arguments.default"> - <title>Vorgabewerte für Parameter</title> - + <title>Vorgabewerte für Parameter</title> + <para> - Eine Funktion kann C++-artige Vorgabewerte für skalare Parameter + Eine Funktion kann C++-artige Vorgabewerte für skalare Parameter wie folgt definieren: - </para> + </para> <para> <example> @@ -277,10 +278,10 @@ </programlisting> </example> </para> - + <para> Die Ausgabe von diesem kleinen Skript ist: - + <screen> Ich mache eine Tasse Cappucino. Ich mache eine Tasse. @@ -288,7 +289,7 @@ </screen> </para> <para> - PHP gestattet es Arrays und den speziellen Typ &null; als + PHP gestattet es, Arrays und den speziellen Typ &null; als Vorgabewert zu nutzen, zum Beispiel: </para> <para> @@ -307,23 +308,23 @@ ?> ]]> </programlisting> - </example> + </example> </para> <simpara> - Der Vorgabewert muss ein konstanter Ausdruck sein, darf also (zum - Beispiel) keine Variable, Eigenschaft einer Klasse oder + Der Vorgabewert muss ein konstanter Ausdruck sein, darf also zum + Beispiel keine Variable, Eigenschaft einer Klasse oder ein Funktionsaufruf sein. </simpara> <para> - Bitte beachten Sie, dass alle Vorgabewerte rechts von den - Nicht-Vorgabeparametern stehen sollten; - sonst wird es nicht + Bitte beachten Sie, dass alle Vorgabewerte rechts von den + Nicht-Vorgabeparametern stehen sollten - sonst wird es nicht funktionieren. Betrachten Sie folgendes Beispiel: </para> <para> <example> - <title>Ungüötige Anwendung von Vorgabewerten</title> + <title>Ungültige Anwendung von Vorgabewerten</title> <programlisting role="php"> <![CDATA[ <?php @@ -331,31 +332,31 @@ { return "Mache einen Becher $typ $geschmack-joghurt.\n"; } - + echo mach_joghurt ("Brombeer"); // arbeitet nicht wie erwartet ?> ]]> </programlisting> </example> </para> - + <para> - Die Ausgabe dieses Beispiels ist:: + Die Ausgabe dieses Beispiels ist: </para> - + <para> <screen> -Warning: Missing argument 2 in call to makeyogurt() in +Warning: Missing argument 2 in call to mach_joghurt() in /usr/local/etc/httpd/htdocs/phptest/functest.html on line 41 Mache einen Becher Brombeer-joghurt. </screen> </para> - + <para> Nun vergleichen Sie bitte oberes Beispiel mit folgendem: </para> - <para> + <para> <example> <title>Richtiger Einsatz von Vorgabewerten</title> <programlisting role="php"> @@ -365,57 +366,58 @@ { return "Mache einen Becher $typ $geschmack-joghurt.\n"; } - + echo mach_joghurt ("Brombeer"); // arbeitet wie erwartet. ?> ]]> </programlisting> </example> </para> - + <para> ... und jetzt ist die Ausgabe: - + <screen> Mache einen Becher rechtsdrehendes Brombeer-Joghurt. </screen> </para> <para> - Default value for arguments passed by reference is supported since PHP 5. - </para> + Das Setzen von Standardwerten für Argumente, die als Verweis übergeben + werden ("passed by reference") wird seit PHP 5 unterstützt. + </para> </sect2> <sect2 xml:id="functions.variable-arg-list"> <title>Variable Anzahl von Parametern</title> - + <simpara> Beginnend mit PHP 4 wird eine variable Anzahl von Parametern in - benutzerdefinierten Funktionen unterstützt. Das Handling dieser Parameter - fällt mittels der Funktionen <function>func_num_args</function>, + benutzerdefinierten Funktionen unterstützt. Das Handling dieser Parameter + fällt mittels der Funktionen <function>func_num_args</function>, <function>func_get_arg</function> und <function>func_get_args</function> sehr leicht. </simpara> <simpara> - Es ist keine spezielle Syntax erforderlich. Die Parameter können + Es ist keine spezielle Syntax erforderlich. Die Parameter können wie gehabt explizit in den Funktionsdeklarationen angegeben - werden, und werden sich wie gewohnt verhalten. + werden und werden sich wie gewohnt verhalten. </simpara> </sect2> </sect1> - + <sect1 xml:id="functions.returning-values"> - <title>Rückgabewerte</title> - + <title>Rückgabewerte</title> + <para> - Sie können Werte mit dem optionalen Befehl "return" zurückgeben. - Es können Variablen jedes Typs zurückgegeben werden, auch Listen - oder Objekte. Die beendet sofort die Funktion, und die Kontrolle - wird wieder an die aufrufende Zeile zurückgegeben. Weitere + Sie können Werte mit dem optionalen Befehl "return" zurückgeben. + Es können Variablen jeden Typs zurückgegeben werden, auch Arrays + oder Objekte. Dies beendet sofort die Funktion und die Kontrolle + wird wieder an die aufrufende Zeile zurückgegeben. Weitere Informationen finden Sie unter <function>return</function>. </para> @@ -436,16 +438,16 @@ </programlisting> </example> </para> - + <para> - Es ist nicht möglich, mehrere Werte von einer Funktion zurückzugeben. - Ein ähnliches Resultat kann man aber durch die Rückgabe von Listen + Es ist nicht möglich, mehrere Werte von einer Funktion zurückzugeben. + Ein ähnliches Resultat kann man aber durch die Rückgabe von Arrays erreichen. </para> - - <para> + + <para> <example> - <title>Rückgabe mehrere Werte in Arrays</title> + <title>Rückgabe mehrere Werte in Arrays</title> <programlisting role="php"> <![CDATA[ <?php @@ -460,14 +462,14 @@ </example> </para> <para> - Um von einer Funktion eine Referenz zurückzugeben, müssen Sie + Um von einer Funktion eine Referenz zurückzugeben, müssen Sie den Referenz-Operator & sowohl in der Funktionsdeklaration, - als auch bei der Zuweisung des zurückgegebenen Wertes verwenden: + als auch bei der Zuweisung des zurückgegebenen Wertes verwenden: </para> <para> <example> - <title>Rückgabe von Referenzen</title> + <title>Rückgabe von Referenzen</title> <programlisting role="php"> <![CDATA[ <?php @@ -483,19 +485,19 @@ </example> </para> <simpara> - Weitere Informationen über Referenzen finden Sie im Kapitel + Weitere Informationen über Referenzen finden Sie im Kapitel <link linkend="language.references">Referenzen in PHP</link>. </simpara> </sect1> - + <sect1 xml:id="functions.variable-functions"> <title>Variablenfunktionen</title> <para> - PHP unterstützt das Konzept der Variablenfunktionen. Wenn Sie an - das Ende einer Variablen Klammern hängen, versucht PHP eine - Funktion aufzurufen, deren Name der aktuelle Wert der Variable - ist. Dies kann unter anderem für Callbacks, Funktionstabellen, + PHP unterstützt das Konzept der Variablenfunktionen. Wenn Sie an + das Ende einer Variablen Klammern hängen, versucht PHP eine + Funktion aufzurufen, deren Name der aktuelle Wert der Variablen + ist. Dies kann unter anderem für Callbacks, Funktionstabellen, usw. genutzt werden. </para> <para> @@ -503,13 +505,13 @@ wie <function>echo</function>, <function>print</function>, <function>unset</function>, <function>isset</function>, <function>empty</function>, <function>include</function> und - <function>require</function>. Sie müssen Ihre eigenen Wrapperfunktionen + <function>require</function>. Sie müssen Ihre eigenen Wrapperfunktionen verwenden, um diese Konstrukte als variable Funktionen benutzen zu - können. + können. </para> <para> <example> - <title>Beispiel für Variablenfunktionen</title> + <title>Beispiel für Variablenfunktionen</title> <programlisting role="php"> <![CDATA[ <?php @@ -523,7 +525,7 @@ echo "In bar(); der Parameter ist '$arg'.<br />\n"; } -// Dies ist eine Wrapperfunkiton für echo +// Dies ist eine Wrapperfunkiton für echo function echoit($string) { echo $string; @@ -543,7 +545,7 @@ </example> </para> <para> - Sie können auch die Methode eines Objektes mittels der variablen + Sie können auch die Methode eines Objektes mittels der variablen Funktionen aufrufen. <example> <title>Variable Methode</title> @@ -557,7 +559,7 @@ $name = 'Bar'; $this->$name(); // Dies ruft die Bar() Methode auf } - + function Bar() { echo "Das ist Bar"; @@ -574,64 +576,61 @@ </example> </para> <para> - Siehe auch <function>call_user_func</function>, - <link linkend="language.variables.variable"> - Variable Variablen</link> und <function>function_exists</function>. + Siehe auch + <function>call_user_func</function>, + <link linkend="language.variables.variable">Variable Variablen</link> und + <function>function_exists</function>. </para> </sect1> - <sect1 xml:id="functions.internal"> <title>Interne (eingebaute) Funktionen</title> <para> - PHP enthält standmäßig viele Funktionen und Konstrukte, weiterhin - gibt es viele Funktionen die vorausssetzen dass bestimmte PHP - Extensions einkompiliert wurden, anderenfalls erhalten Sie beim - Aufruf "undefined function" Fehlermeldungen. + PHP enthält standmäÃig viele Funktionen und Konstrukte, weiterhin + gibt es viele Funktionen die vorausssetzen, dass bestimmte PHP-Extensions + einkompiliert wurden, anderenfalls erhalten Sie beim + Aufruf "undefined function"-Fehlermeldungen. Um z.B. <link linkend="ref.image">Grafik-Funktionen</link> wie - <function>imagecreatetruecolor</function> müssen Sie PHP mit - <productname>GD</productname> Unterstützung kompilieren, oder um - <function>mysql_connect</function> - zu Nutzen muss Ihr PHP mit <link linkend="ref.mysql">MySQL</link> - UNterstützung compiliert sein. - Viele Kernfunktionen wie z.B. die <link linkend="ref.strings" - >String</link>- und <link linkend="language.variables">Variablen</link - >-Funktionen sind bereits in jeder PHP Version enthalten. - Ein Aufruf von <function>phpinfo</function> oder <function - >get_loaded_extensions</function> zeigt Ihnen welche Extensions - in Ihrer PHP Installation verfügbar sind. - Beachten Sie weiterhin das viele Extensions bereits standardmäßig - aktiviert sind und das PHP Manual nach Extensions unterteilt ist. + <function>imagecreatetruecolor</function> zu nutzen, müssen Sie PHP mit + <productname>GD</productname>-Unterstützung kompilieren, oder um + <function>mysql_connect</function> zu nutzen, muss Ihr PHP mit <link + linkend="ref.mysql">MySQL</link>-Unterstützung kompiliert sein. + Viele Kernfunktionen wie z.B. die <link + linkend="ref.strings">String</link>- und <link + linkend="language.variables">Variablen</link>-Funktionen sind bereits in + jeder PHP-Version enthalten. Ein Aufruf von <function>phpinfo</function> + oder <function>get_loaded_extensions</function> zeigt Ihnen, welche + Extensions in Ihrer PHP-Installation verfügbar sind. + Beachten Sie weiterhin, dass viele Extensions bereits standardmäÃig + aktiviert sind und das PHP-Manual nach Extensions unterteilt ist. Weitere Informationen zur Einrichtung von PHP finden Sie in den - Kapiteln <link linkend="configuration">konfiguration</link>, + Kapiteln <link linkend="configuration">Konfiguration</link>, <link linkend="install">Installation</link> und den Kapiteln zu den einzelnen Extensions. </para> <para> - Wie Funktionsprototypen zu lesen und zu verstehen sind ist im - Kapitel '<link linkend="about.prototypes">Wie man eine Funktionsdefinition - (Prototyp) liest'</link> erklärt. - Es ist wichtig zu erkennen was eine Funktion zurückgibt und ob - die übergebenen Parameter verändert werden. So gibt z.B. - <function>str_replace</function> den bearbeiteten String zurück - während <function>usort</function> direkt auf der übergebenen + Wie Funktionsprototypen zu lesen und zu verstehen sind, ist im + Kapitel '<link linkend="about.prototypes">Wie man eine Funktionsdefinition + (Prototyp) liest'</link> erklärt. + Es ist wichtig zu erkennen, was eine Funktion zurückgibt und ob + die übergebenen Parameter verändert werden. So gibt z.B. + <function>str_replace</function> den bearbeiteten String zurück, + während <function>usort</function> direkt auf der übergebenen Variablen arbeitet. - itself. - Jede Handbuchseite enthält spezifische Informatione für jede - Funktion wie ihre Parameter, Rückgabewerte sowohl bei Erfolg - als auch im Fehlerfall, Änderungen des Verhaltens und Verfügbarkeit. - Kenntniss dieser wichtigen (und oft subtilen) Unterschiede ist - von entscheidender Bedeutung für das Schreiben korekten PHP Kodes. + Jede Handbuchseite enthält spezifische Informationen für jede + Funktion wie ihre Parameter, die Rückgabewerte sowohl bei Erfolg + als auch im Fehlerfall, Ãnderungen des Verhaltens und die Verfügbarkeit. + Die Kenntnis dieser wichtigen (und oft subtilen) Unterschiede ist + von entscheidender Bedeutung für das Schreiben korrekten PHP-Codes. </para> <note> <simpara> Wenn Funktionen andere Parameter erhalten als erwartet, d.h. wenn z.B. - ein <type>array</type> übergeben wird obwohl ein <type>string</type> - erwartet wird, so ist der Rückgabewert undefiniert. In solchen Fällen - ist es üblich das &null; zurückgegeben wird, dies ist aber nur eine - Konvention auf die Sie sich nicht unbedingt verlassen können. - upon. + ein <type>array</type> übergeben wird obwohl ein <type>string</type> + erwartet wird, so ist der Rückgabewert undefiniert. In solchen Fällen + ist es üblich, dass &null; zurückgegeben wird, dies ist aber nur eine + Konvention, auf die Sie sich nicht unbedingt verlassen können. </simpara> </note> <para> @@ -642,7 +641,7 @@ </para> </sect1> </chapter> - + <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/viewvc.cgi/phpdoc-de/language-snippets.ent?r1=1.36&r2=1.37&diff_format=u Index: phpdoc-de/language-snippets.ent diff -u phpdoc-de/language-snippets.ent:1.36 phpdoc-de/language-snippets.ent:1.37 --- phpdoc-de/language-snippets.ent:1.36 Mon Jun 16 22:50:17 2008 +++ phpdoc-de/language-snippets.ent Tue Jun 17 12:08:18 2008 @@ -1,5 +1,5 @@ -<?xml version='1.0' encoding='ISO-8859-1' ?> -<!-- $Revision: 1.36 $ --> +<?xml version='1.0' encoding='utf-8' ?> +<!-- $Revision: 1.37 $ --> <!-- EN-Revision: 1.219 Maintainer: hholzgra Status: ready --> <!-- CREDITS: mk, betz --> @@ -14,65 +14,65 @@ werden gecached. Weitere Details erhalten Sie bei <function>clearstatcache</function>.</simpara></note>'> -<!ENTITY note.context-support '<note><simpara>Die Kontext-Unterstützung gibt +<!ENTITY note.context-support '<note><simpara>Die Kontext-Unterstützung gibt es seit PHP 5.0.0. Eine Beschreibung von <literal>Kontexten</literal> finden Sie unter <xref linkend="ref.stream"/>.</simpara></note>'> <!ENTITY note.exec-bg '<note><para>Falls Sie diese Funktion benutzen, um ein -Programm zu starten und im Hintergrund weiterlaufen lassen möchten, -müssen Sie sicherstellen, dass die Ausgabe des Programms in eine Datei oder +Programm zu starten und im Hintergrund weiterlaufen lassen möchten, +müssen Sie sicherstellen, dass die Ausgabe des Programms in eine Datei oder einen anderen Ausgabestream umgeleitet wird. Anderenfalls wird PHP solange -hängen, bis das Programm zu Ende ausgeführt wurde.</para></note>'> +hängen, bis das Programm zu Ende ausgeführt wurde.</para></note>'> <!ENTITY note.func-callback '<note><simpara>Anstelle eines Funktionsnamens kann auch ein Array mit einer Objekt-Referenz und dem Namen einer Methode angegeben werden.</simpara></note>'> <!ENTITY note.funcnoparam '<note><para>Da diese Funktion bei der Ermittlung -der Parameterdetails von dem aktuellen Ausführungskontext abhängt kann sie +der Parameterdetails von dem aktuellen Ausführungskontext abhängt kann sie selbst nicht als Funktionsparameter genutzt werden. Wenn Sie ihre Ergebnisse -tatsächlich weitergeben müssen so müssen Sie diese zunächst an eine Variable -zuweisen und dann diese Variable übergeben</para></note>'> +tatsächlich weitergeben müssen so müssen Sie diese zunächst an eine Variable +zuweisen und dann diese Variable übergeben</para></note>'> <!ENTITY note.line-endings '<note><simpara>Wenn Sie Probleme damit haben, dass PHP Zeilenendezeichen nicht erkennt, entweder beim Lesen von Dateien auf einem -Macintosh oder bei Dateien die auf einem Macintosh erstellt wurden, können Sie +Macintosh oder bei Dateien die auf einem Macintosh erstellt wurden, können Sie die Option <link linkend="ini.auto-detect-line-endings"> auto_detect_line_endings</link> aktivieren.</simpara></note>'> <!ENTITY note.no-remote '<note><simpara>Diese Funktion kann nicht mit <link linkend="features.remote-files">entfernten Dateien</link> arbeiten, da -der Zugriff auf die Datei, die bearbeitet werden soll, über das Dateisystem des -Servers möglich sein muss.</simpara></note>'> +der Zugriff auf die Datei, die bearbeitet werden soll, über das Dateisystem des +Servers möglich sein muss.</simpara></note>'> <!ENTITY note.no-key-association '<note><simpara>Diese Funktion weist den -Elementen des Arrays <parameter>array</parameter> neue Schlüssel zu. -Bestehende Schlüssel die Sie eventuell zugewiesen haben werden entfernt -statt einfach nur die Schlüssel neu anzuordnen</simpara></note>'> +Elementen des Arrays <parameter>array</parameter> neue Schlüssel zu. +Bestehende Schlüssel die Sie eventuell zugewiesen haben werden entfernt +statt einfach nur die Schlüssel neu anzuordnen</simpara></note>'> <!ENTITY note.no-windows '<note><simpara>Diese Funktion ist auf Windows-Plattformen nicht implementiert.</simpara></note>'> <!ENTITY note.no-windows.extension '<note><simpara>Diese Erweiterung steht auf -Windowsbetriebssystemen nicht zur Verfügung.</simpara></note>'> +Windowsbetriebssystemen nicht zur Verfügung.</simpara></note>'> <!ENTITY note.randomseed '<note><simpara>Seit PHP 4.2.0 besteht keine -Notwendigkeit mehr, den Zufallsgenerator für Zahlen mit -<function>srand</function> oder <function>mt_srand</function> zu füttern, das +Notwendigkeit mehr, den Zufallsgenerator für Zahlen mit +<function>srand</function> oder <function>mt_srand</function> zu füttern, das geschieht nun automatisch.</simpara></note>'> <!ENTITY note.registerglobals '<note><title>register_globals: Wichtiger -Hinweis</title><para>Seit PHP 4.2.0 ist die Standardeinsteillung für die +Hinweis</title><para>Seit PHP 4.2.0 ist die Standardeinsteillung für die Konfigurationsoption <link linkend="ini.register-globals"> -register_globals</link> <emphasis>off</emphasis> und in PHP 6 wird -diese Option endgültig entfernt. Die PHP Community ermutigt +register_globals</link> <emphasis>off</emphasis> und in PHP 6 wird +diese Option endgültig entfernt. Die PHP Community ermutigt alle, sich nicht auf diese Option zu verlassen und Alternativen wie &link.superglobals; zu verwenden.</para></note>'> <!ENTITY note.superglobals '<note><title>Superglobals: Hinweis zur -Verfügbarkeit</title><para>Seit PHP 4.1.0 stehen superglobale Arrays wie +Verfügbarkeit</title><para>Seit PHP 4.1.0 stehen superglobale Arrays wie <varname>$_GET</varname>, <varname>$_POST</varname>,<varname>$_SERVER</varname>, -etc. zur Verfügung. Weitere Informationen können Sie dem Abschnitt zu +etc. zur Verfügung. Weitere Informationen können Sie dem Abschnitt zu &link.superglobals; entnehmen.</para></note>'> <!ENTITY note.uses-ob '<note><para>Diese Funktion benutzt intern @@ -82,25 +82,25 @@ <!-- Tips --> -<!ENTITY tip.fopen-wrapper '<tip><simpara>Mit dieser Funktion können Sie eine +<!ENTITY tip.fopen-wrapper '<tip><simpara>Mit dieser Funktion können Sie eine URL als Dateinamen verwenden, falls Sie <link linkend="ini.allow-url-fopen"> -fopen wrappers</link> ermöglicht haben. Mehr Details dazu, wie Sie den -Dateinamen angeben müssen finden Sie bei <function>fopen</function>. Eine -Liste der unterstützten URL Protokolle finden Sie unter +fopen wrappers</link> ermöglicht haben. Mehr Details dazu, wie Sie den +Dateinamen angeben müssen finden Sie bei <function>fopen</function>. Eine +Liste der unterstützten URL Protokolle finden Sie unter <xref linkend="wrappers"/>.</simpara></tip>'> <!ENTITY tip.fopen-wrapper.stat '<tip><simpara>Seit PHP 5.0.0 kann diese Funktion mit <emphasis>einigen</emphasis> URL-Wrappern benutzt werden. Schauen Sie in der Liste unter <xref linkend="wrappers"/> nach, welcher Wrapper die -Funktionalität von <function>stat</function> unterstützt.</simpara></tip>'> +Funktionalität von <function>stat</function> unterstützt.</simpara></tip>'> <!ENTITY tip.ob-capture '<tip><simpara>Bei allem, dessen Ergebnisausgabe direkt -im Browser angezeigt wird, können Sie die +im Browser angezeigt wird, können Sie die <link linkend="ref.outcontrol">Funktionen zur Ausgabesteuerung</link> verwenden. -Damit lässt sich die Ausgabe dieser Funktion erfassen, und - zum Beispiel - +Damit lässt sich die Ausgabe dieser Funktion erfassen, und - zum Beispiel - in einem <type>string</type> speichern.</simpara></tip>'> -<!ENTITY tip.userlandnaming '<tip><simpara>Siehe auch<xref linkend="userlandnaming" +<!ENTITY tip.userlandnaming '<tip><simpara>Siehe auch<xref linkend="userlandnaming" />.</simpara></tip>'> <!-- Warnings --> @@ -109,19 +109,19 @@ Usereingaben an diese Funktion weitergereicht werden, sollten Sie <function>escapeshellarg</function> oder <function>escapeshellcmd</function> verwenden. Bei Verwendung dieser Funktionen stellen Sie sicher, dass kein -Benutzer Ihr System überlisten kann beliebige Kommandos auszuführen</para></warning>'> +Benutzer Ihr System überlisten kann beliebige Kommandos auszuführen</para></warning>'> <!ENTITY warn.experimental '<warning xmlns="http://docbook.org/ns/docbook"> <simpara>Diese Erweiterung ist <emphasis>EXPERIMENTELL</emphasis>. Das Verhalten dieser Erweiterung, -einschließlich der Funktionsnamen, und alles Andere was hier dokumentiert -ist, kann sich in zukünftigen PHP-Versionen ohne Ankündigung ändern. Seien +einschlieÃlich der Funktionsnamen, und alles Andere was hier dokumentiert +ist, kann sich in zukünftigen PHP-Versionen ohne Ankündigung ändern. Seien Sie gewarnt und verwenden Sie diese Erweiterung auf eigenes Risiko. </simpara></warning>'> <!ENTITY warn.deprecated.removed-6-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara> Dieses Feature ist <emphasis>DEPRECATED</emphasis> (veraltet) und wird in PHP 6.0.0 -<emphasis>ENTFERNT</emphasis>. Sich auf dieses Feature zu verlassen ist +<emphasis>ENTFERNT</emphasis>. Sich auf dieses Feature zu verlassen ist in keiner Weise empfehlenswert.</simpara></warning>'> <!ENTITY warn.deprecated.function.removed-5-3-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara> @@ -131,49 +131,49 @@ <!ENTITY warn.experimental.func '<warning xmlns="http://docbook.org/ns/docbook"> <simpara>Diese Funktion ist <emphasis>EXPERIMENTELL</emphasis>. Das Verhalten, der Funktionsname und alles -Andere was hier dokumentiert ist, kann sich in zukünftigen PHP-Versionen ohne -Ankündigung ändern. Seien Sie gewarnt und verwenden Sie diese Funktion auf +Andere was hier dokumentiert ist, kann sich in zukünftigen PHP-Versionen ohne +Ankündigung ändern. Seien Sie gewarnt und verwenden Sie diese Funktion auf eigenes Risiko.</simpara></warning>'> <!ENTITY warn.imaprecodeyaz '<warning><simpara>Die <link -linkend="ref.imap">IMAP</link> , <link linkend="ref.recode">recode</link>, +linkend="ref.imap">IMAP</link> , <link linkend="ref.recode">recode</link>, <link linkend="ref.yaz">YAZ</link> und <link linkend="ref.cyrus">Cyrus</link> -können nicht zusammen verwendet werden. Diese Tatsache -liegt darin begründet, dass alle diese Erweiterungen die gleichen internen Symbole +können nicht zusammen verwendet werden. Diese Tatsache +liegt darin begründet, dass alle diese Erweiterungen die gleichen internen Symbole benutzen.</simpara></warning>'> <!ENTITY warn.install.cgi '<warning><para>Wenn Sie das CGI Setup verwenden, -ist Ihr Server für einige mögliche Angriffe anfällig. Wie Sie sich vor diesen -Angriffen schützen können, entnehmen Sie bitte dem -<link linkend="security.cgi-bin">Kapitel über CGI Sicherheit</link>.</para></warning>'> +ist Ihr Server für einige mögliche Angriffe anfällig. Wie Sie sich vor diesen +Angriffen schützen können, entnehmen Sie bitte dem +<link linkend="security.cgi-bin">Kapitel über CGI Sicherheit</link>.</para></warning>'> <!ENTITY note.magicquotes.gpc '<note><title>Hinweis zu magic_quotes_gpc </title><para>Die PHP Konfigurationsoption <link linkend="ini.magic-quotes-gpc"> magic_quotes_gpc</link> ist im Standard auf <literal>on</literal> gesetzt. Das -bedeutet, dass <function>addslashes</function> für alle GET, POST und COOKIE -Daten automatisch ausgeführt wird. Sie können <function>stripslashes</function> +bedeutet, dass <function>addslashes</function> für alle GET, POST und COOKIE +Daten automatisch ausgeführt wird. Sie können <function>stripslashes</function> verwenden um diese Slashes zu entfernen.</para></note>'> <!ENTITY warn.no-win32-fopen-wrapper '<warning><para>PHP Versionen kleiner 4.3.0 -für Windows, erlauben den Zugriff auf Remote-Dateien mit dieser Funktion nicht, +für Windows, erlauben den Zugriff auf Remote-Dateien mit dieser Funktion nicht, selbst wenn <link linkend="ini.allow-url-fopen">allow_url_fopen</link> aktiviert ist.</para></warning>'> <!ENTITY warn.ssl-non-standard '<warning><para>Bei SSL-Verbindungen zusammen -mit Microsoft IIS hält sich dieser Webserver nicht an das Protokoll und -schließt die Verbindung ohne ein <literal>close_notify</literal> zu senden. -PHP quittiert dieses Fehlverhalten mit "SSL: Fatal Protocol Error", wenn das -Ende der Daten erreicht ist. Eine mögliche Lösung besteht darin, das Level von +mit Microsoft IIS hält sich dieser Webserver nicht an das Protokoll und +schlieÃt die Verbindung ohne ein <literal>close_notify</literal> zu senden. +PHP quittiert dieses Fehlverhalten mit "SSL: Fatal Protocol Error", wenn das +Ende der Daten erreicht ist. Eine mögliche Lösung besteht darin, das Level von <link linkend="ini.error-reporting">error_reporting</link> herabzusetzten und -warnings auzuschließen. Ab PHP 4.3.7 kann PHP fehlerhafte IIS Serversoftware -erkennen, wenn Sie einen Stream mit dem <literal>https://</literal> Wrapper öffnen -und unterdrückt die Warnung für Sie. Falls Sie <function>fsockopen</function> -benutzen um einen <literal>ssl://</literal> Socket zu öffnen, müssen Sie selbst -dafür Sorge tragen, die Warnung zu erkennen und diese zu unterdrücken.</para> +warnings auzuschlieÃen. Ab PHP 4.3.7 kann PHP fehlerhafte IIS Serversoftware +erkennen, wenn Sie einen Stream mit dem <literal>https://</literal> Wrapper öffnen +und unterdrückt die Warnung für Sie. Falls Sie <function>fsockopen</function> +benutzen um einen <literal>ssl://</literal> Socket zu öffnen, müssen Sie selbst +dafür Sorge tragen, die Warnung zu erkennen und diese zu unterdrücken.</para> </warning>'> <!ENTITY warn.undocumented.func '<warning><simpara>Diese Funktion ist bis jetzt -nicht dokumentiert. Es steht nur die Liste der Argumente zur Verfügung. +nicht dokumentiert. Es steht nur die Liste der Argumente zur Verfügung. </simpara></warning>'> @@ -185,141 +185,141 @@ Ausgabe:</para>'> <!ENTITY example.outputs.similar '<para>Das oben gezeigte Beispiel erzeugt -eine ähnliche Ausgabe wie: </para>'> +eine ähnliche Ausgabe wie: </para>'> <!ENTITY array.resetspointer '<note><simpara>Diese Funktion setzt (<function>reset</function>) nach Verwendung den <type>array</type>-Zeiger -zurück.</simpara></note>'> +zurück.</simpara></note>'> -<!ENTITY seealso.callback 'Informationen über den <link +<!ENTITY seealso.callback 'Informationen über den <link linkend="language.types.callback">Callback</link>-Typ'> -<!ENTITY avail.register-long-arrays 'Seit PHP 5.0.0 können Sie die +<!ENTITY avail.register-long-arrays 'Seit PHP 5.0.0 können Sie die Registrierung der langen von PHP <link linkend="language.variables.predefined"> vordefinierten Arrays</link> mit der Konfigurationsoption <link linkend="ini.register-long-arrays">register_long_arrays</link> abschalten.'> <!ENTITY ini.shorthandbytes '<simpara>Wird ein <type>integer</type> Wert -verwendet, wird dieser Wert in Bytes gemessen. Sie können auch die +verwendet, wird dieser Wert in Bytes gemessen. Sie können auch die Kurzschreibweise verwenden, wie in <link linkend="faq.using.shorthandbytes"> dieser FAQ</link> beschrieben.</simpara>'> -<!ENTITY info.deprecated.alias 'Für die Abwärtskompatibiliät kann der +<!ENTITY info.deprecated.alias 'Für die Abwärtskompatibiliät kann der folgende veraltete Alias verwendet werden: '> -<!ENTITY info.function.alias 'Diese Funktion ist ein Alias für: '> +<!ENTITY info.function.alias 'Diese Funktion ist ein Alias für: '> <!ENTITY info.function.alias.deprecated '<simpara>Dieser Funktion-Alias -ist veraltet und existiert nur noch aus Gründen der Rückwärtskompatibilität. +ist veraltet und existiert nur noch aus Gründen der Rückwärtskompatibilität. Es wird nicht empfohlen diese Funktion weiter zu nutzen da sie eines Tages aus PHP entfernt werden kann.</simpara>'> <!ENTITY ext.windows.path.dll 'Diese Extension benotigt <acronym>DLL</acronym> -Dateien die für Windows verfügbar seien müssen. Der <acronym>FAQ</acronym> Eintrag -"<link linkend="faq.installation.addtopath"> Wie füge ich unter Windows PATH mein -PHP-Verzeichnis hinzu?</link>" gibt hierzu weitere Informationen. Obwohl ein +Dateien die für Windows verfügbar seien müssen. Der <acronym>FAQ</acronym> Eintrag +"<link linkend="faq.installation.addtopath"> Wie füge ich unter Windows PATH mein +PHP-Verzeichnis hinzu?</link>" gibt hierzu weitere Informationen. Obwohl ein einfaches Kopieren der DLL Dateien vom PHP Verzeichnis in den Windows -Systemordner auch funktioniert (weil der Systemordner immer im +Systemordner auch funktioniert (weil der Systemordner immer im <literal>PATH</literal> enthalten ist) ist dieses Vorgehen nicht empfehlenswert. -<emphasis>Diese Extension benötigt die folgenden Dateien im <literal>PATH</literal>: +<emphasis>Diese Extension benötigt die folgenden Dateien im <literal>PATH</literal>: </emphasis>'> <!-- Returns --> -<!ENTITY return.success 'Gibt bei Erfolg &true; zurück, im Fehlerfall &false;.'> +<!ENTITY return.success 'Gibt bei Erfolg &true; zurück, im Fehlerfall &false;.'> -<!ENTITY return.void 'Es wird kein Wert zurückgegeben.'> +<!ENTITY return.void 'Es wird kein Wert zurückgegeben.'> <!ENTITY return.falseproblem '<warning><simpara>Diese Funktion kann sowohl das -Boolsche &false; zurückliefern, als auch einen nicht-Boolschen Wert, wie zum +Boolsche &false; zurückliefern, als auch einen nicht-Boolschen Wert, wie zum Beispiel<literal>0</literal> oder "". der von einem einfachen if-Statement als &false; ausgewertet wird. Weitere Informationen entnehmen Sie -bitte dem Abschnitt über die <link linkend="language.types.boolean"> +bitte dem Abschnitt über die <link linkend="language.types.boolean"> Boolsche Typen</link>. Benutzen Sie deshalb <link linkend="language.operators.comparison">den === Operator</link> -um den Rückgabewert dieser Funktion zu überprüfen.</simpara></warning>'> +um den Rückgabewert dieser Funktion zu überprüfen.</simpara></warning>'> <!-- Image (GD) Notes --> <!ENTITY note.config.t1lib '<note><simpara>Diese Funktion steht nur zur -Verfügung, wenn PHP mit der Option <option -role="configure">--with-t1lib[=DIR]</option> übersetzt +Verfügung, wenn PHP mit der Option <option +role="configure">--with-t1lib[=DIR]</option> übersetzt wurde.</simpara></note>'> -<!ENTITY note.config.jpeg '<note><simpara>Die Unterstützung von JPEG steht nur -zur Verfügung, wenn PHP mit GD-1.8 oder höher übersetzt +<!ENTITY note.config.jpeg '<note><simpara>Die Unterstützung von JPEG steht nur +zur Verfügung, wenn PHP mit GD-1.8 oder höher übersetzt wurde.</simpara></note>'> -<!ENTITY note.config.wbmp '<note><simpara>Die Unterstützung von WBMP steht nur -zur Verfügung, wenn PHP mit GD-1.8 oder höher übersetzt +<!ENTITY note.config.wbmp '<note><simpara>Die Unterstützung von WBMP steht nur +zur Verfügung, wenn PHP mit GD-1.8 oder höher übersetzt wurde.</simpara></note>'> -<!ENTITY note.bundled.gd '<note><simpara>Diese Funktion steht nur zur Verfügung, -wenn PHP mit der GD Bibliothek übersetzt wurde, die mit PHP zusammen erhältlich +<!ENTITY note.bundled.gd '<note><simpara>Diese Funktion steht nur zur Verfügung, +wenn PHP mit der GD Bibliothek übersetzt wurde, die mit PHP zusammen erhältlich ist.</simpara></note>'> -<!ENTITY note.freetype '<note><simpara>Diese Funktion ist nur verfügbar -wenn PHP mit Freetype unterstützung (<option role="configure">--with-freetype-dir=DIR</option>) +<!ENTITY note.freetype '<note><simpara>Diese Funktion ist nur verfügbar +wenn PHP mit Freetype unterstützung (<option role="configure">--with-freetype-dir=DIR</option>) kompiliert wurde</simpara></note>'> <!ENTITY note.gd.2 '<note><simpara>Diese Funktion setzt die GD Bibliothek in -der Version 2.0.1 oder höher (empfohlen wird mindestens 2.0.28) voraus.</simpara></note>'> +der Version 2.0.1 oder höher (empfohlen wird mindestens 2.0.28) voraus.</simpara></note>'> <!ENTITY gd.image.description '<varlistentry><term><parameter>image</parameter> </term><listitem><para>Eine von den verschiedenen Erzeugungsfunktionen wie <function>imagecreatetruecolor</function> gelieferte Grafikresource.</para> </listitem></varlistentry>'> - + <!ENTITY gd.font.description '<varlistentry><term><parameter> -font</parameter></term><listitem><para>Ein Wert zwischen 1 und 5 für -eingebaute Schriftarten in Latin2 kodierung (wobei größere Werte größeren -Schriften entsprechen) oder einer Ihrer mit <function>imageloadfont</function> -selbst registrierten Schrifteinträge.</para></listitem></varlistentry>'> +font</parameter></term><listitem><para>Ein Wert zwischen 1 und 5 für +eingebaute Schriftarten in Latin2 kodierung (wobei gröÃere Werte gröÃeren +Schriften entsprechen) oder einer Ihrer mit <function>imageloadfont</function> +selbst registrierten Schrifteinträge.</para></listitem></varlistentry>'> <!-- DBM notes --> - + <!ENTITY dbm.dbm-identifier.description '<varlistentry><term><parameter> dbm_identifier</parameter></term><listitem><para>Ein von <function>dbmopen</function> -zurückgegebenes DBM Verbindungshandle.</para></listitem></varlistentry>'> +zurückgegebenes DBM Verbindungshandle.</para></listitem></varlistentry>'> <!-- cURL notes --> - + <!ENTITY curl.ch.description '<varlistentry><term><parameter>ch</parameter> -</term><listitem><para>Ein von <function>curl_init</function> zurückgegebenes +</term><listitem><para>Ein von <function>curl_init</function> zurückgegebenes cURL-Handle.</para></listitem></varlistentry>'> - + <!ENTITY curl.mh.description '<varlistentry><term><parameter>mh</parameter> -</term><listitem><para>Ein von <function>curl_multi_init</function> zurückgegebenes +</term><listitem><para>Ein von <function>curl_multi_init</function> zurückgegebenes cURL-Multihandle.</para></listitem></varlistentry>'> <!-- IMAP notes --> - + <!ENTITY imap.imap-stream.description '<varlistentry><term><parameter> imap_stream</parameter></term><listitem><para>Eine von <function>imap_open</function> -zurückgegebene IMAP-Verbindung.</para></listitem></varlistentry>'> +zurückgegebene IMAP-Verbindung.</para></listitem></varlistentry>'> <!-- mbstring notes --> -<!ENTITY note.mbstring.encoding.internal '<note><para>Das interne +<!ENTITY note.mbstring.encoding.internal '<note><para>Das interne Encoding oder das mit <function>mb_regex_encoding</function> festgelegte -Zeichenencoding wird als Zeichenencoding für diese Funktion genutzt.</para></note>'> - +Zeichenencoding wird als Zeichenencoding für diese Funktion genutzt.</para></note>'> + <!ENTITY mbstring.encoding.parameter '<para>Der <parameter>encoding</parameter> -Parameter legt das Zeichenencoding fest. Wird er nicht übergeben so wird +Parameter legt das Zeichenencoding fest. Wird er nicht übergeben so wird das interne Zeichenencoding genutzt.</para>'> <!-- MCVE notes --> - + <!ENTITY mcve.conn.description '<varlistentry><term><parameter> conn</parameter></term><listitem><para>Eine von <function>m_initengine</function> -zurückgegebene MCVE_CONN Resource.</para></listitem></varlistentry>'> +zurückgegebene MCVE_CONN Resource.</para></listitem></varlistentry>'> <!-- Date and time entities --> -<!ENTITY note.timezone.errors.description '<para>Jeder Aufruf der Datums- und Zeitfunktionen +<!ENTITY note.timezone.errors.description '<para>Jeder Aufruf der Datums- und Zeitfunktionen Funktionen eine <constant>E_NOTICE</constant> Warnung -wenn die Zeitzone ungültig ist und eine <constant>E_STRICT</constant> +wenn die Zeitzone ungültig ist und eine <constant>E_STRICT</constant> Nachricht wenn die Systemeinstellung oder die <varname>TZ</varname> -Umgebungsvariable genutzt wird. Sie auch +Umgebungsvariable genutzt wird. Sie auch <function>date_default_timezone_set</function> </para>'> @@ -331,45 +331,45 @@ <varlistentry><term><parameter>timestamp</parameter></term><listitem><para> Der optionale Parameter <parameter>timestamp</parameter> ist ein Unix Timestamp als <type>integer</type> oder die aktuelle lokale Zeit -wenn kein <parameter>timestamp</parameter> übergeben wurde. Er entspricht +wenn kein <parameter>timestamp</parameter> übergeben wurde. Er entspricht dann also dem Ergebnis der Funktion <function>time</function>. </para></listitem></varlistentry>'> <!-- DomXml Notes --> <!ENTITY node.inserted 'Dieser Knoten wird in Ihrem Dokument nicht sichtbar sein, bis dieser zum Beispiel mit der Funktion <function>domnode_append_child -</function> eingefügt wird.'> +</function> eingefügt wird.'> <!-- Dom Notes --> <!ENTITY dom.node.inserted 'Dieser Knoten wird in Ihrem Dokument nicht sichtbar sein, bis dieser zum Beispiel mit der Funktion <link linkend="domnode.appendchild">DOMNode->appendChild()</link> -eingefügt wird.'> +eingefügt wird.'> <!-- FileSystem entities --> -<!ENTITY fs.validfp.all '<para>Der Zeiger auf eine Datei muss gültig sein und +<!ENTITY fs.validfp.all '<para>Der Zeiger auf eine Datei muss gültig sein und auf eine Datei verweisen, die vorher erfolgreich mit <function>fopen</function> -oder <function>fsockopen</function> geöffnet (und nicht bereits von +oder <function>fsockopen</function> geöffnet (und nicht bereits von <function>fclose</function> geschlossen) wurde.</para>'> <!ENTITY fs.file.pointer '<para>Eine Dateisystem <type>resource</type> -wie sie in dr Regel von <function>fopen</function> zurückgegeben wird. +wie sie in dr Regel von <function>fopen</function> zurückgegeben wird. </para>'> <!-- Oracle --> <!ENTITY oci.charset "<para>Wenn Sie den Oracle Server in der Version 9.2 oder -höher benutzen, können Sie den Zeichensatz, der für eine neue Verbindung +höher benutzen, können Sie den Zeichensatz, der für eine neue Verbindung genutzt werden soll, mit dem <parameter>charset</parameter> Parameter angeben. Verwenden Sie Oracle in einer Version < 9.2 wird dieser Parameter ignoriert und stattdessen die Umgebungsvariable <literal>NLS_LANG</literal> benutzt.</para>"> -<!ENTITY oci.datatypes '<para>Für Details zur vom OCI8 Treiber durchgeführten -Umsetzung von Datentypen siehe die<link linkend="oci8.datatypes" ->vom Treiber unterstützen Datentypen</link></para>'> +<!ENTITY oci.datatypes '<para>Für Details zur vom OCI8 Treiber durchgeführten +Umsetzung von Datentypen siehe die <link linkend="oci8.datatypes" +>vom Treiber unterstützen Datentypen</link>.</para>'> <!-- PCNTL Notes --> <!ENTITY pcntl.parameter.status '<para>Der <parameter>status</parameter> -Parameter entspricht dem Statusparameter der für einen erfolgreichen Aufruf +Parameter entspricht dem Statusparameter der für einen erfolgreichen Aufruf von <function>pcntl_waitpid</function> verwendet wird.</para>'> <!-- XSLT Notes --> @@ -380,21 +380,21 @@ <!ENTITY note.sm.disabled '<note><simpara>&sm.disabled;</simpara></note>'> <!ENTITY note.sm.uidcheck '<note><simpara>Wenn <link -linkend="features.safe-mode">Safe Mode</link> aktiviert ist, überprüft PHP, +linkend="features.safe-mode">Safe Mode</link> aktiviert ist, überprüft PHP, ob die Dateien/Verzeichnisse die mit dem Skript bearbeitet werden sollen, -die gleiche UID (Eigentümer) haben wie das Skript selbst.</simpara></note>'> +die gleiche UID (Eigentümer) haben wie das Skript selbst.</simpara></note>'> <!ENTITY note.sm.uidcheck.dir '<note><simpara>Wenn <link -linkend="features.safe-mode">Safe Mode</link> aktiviert ist überprüft PHP ob -das Arbeitsverzeichnis, die gleiche UID (Eigentümer) hat wie das Skript selbst. +linkend="features.safe-mode">Safe Mode</link> aktiviert ist überprüft PHP ob +das Arbeitsverzeichnis, die gleiche UID (Eigentümer) hat wie das Skript selbst. </simpara></note>'> -<!ENTITY note.open-basedir.func '<note><para>Diese Funktion wird von <link +<!ENTITY note.open-basedir.func '<note><para>Diese Funktion wird von <link linkend="ini.open-basedir">open_basedir</link> beeinflusst.</para></note>'> <!ENTITY note.language-construct '<note><simpara>Da dies ein Sprachkonstrukt -und keine Funktion ist, deshalb können Sie dieses nicht mit +und keine Funktion ist, deshalb können Sie dieses nicht mit <link linkend="functions.variable-functions">Variablenfunktionen</link> verwenden.</simpara></note>'> @@ -403,8 +403,8 @@ should have been inline in safe-mode.xml --> -<!ENTITY sm.uidcheck 'Überprüft ob die Dateien/Verzeichnisse, die mit dem Skript -bearbeitet werden sollen, die gleiche UID Eigentümer haben wie das Skript +<!ENTITY sm.uidcheck 'Ãberprüft ob die Dateien/Verzeichnisse, die mit dem Skript +bearbeitet werden sollen, die gleiche UID Eigentümer haben wie das Skript selbst.'> <!ENTITY warn.sm.exec '<warning><simpara>Mit aktiviertem <link @@ -414,28 +414,28 @@ </simpara></warning>'> <!ENTITY note.exec-path '<note><simpara>Mit aktiviertem <link -linkend="features.safe-mode">Safe Mode</link> können Sie nur Programme -ausführen, die im Verzeichnis liegen, das mit <link +linkend="features.safe-mode">Safe Mode</link> können Sie nur Programme +ausführen, die im Verzeichnis liegen, das mit <link linkend="ini.safe-mode-exec-dir">safe_mode_exec_dir</link> angegeben wurde. Aus -praktischen Gründen ist es gegenwärtig nicht erlaubt, dass der Pfad zu einem -Programm <literal>..</literal> enthält.</simpara></note>'> +praktischen Gründen ist es gegenwärtig nicht erlaubt, dass der Pfad zu einem +Programm <literal>..</literal> enthält.</simpara></note>'> -<!ENTITY sm.uidcheck.dir 'Überprüft ob das Verzeichnis in dem das Skript -ausgeführt werden soll, die gleiche UID (Eigentümer) hat wie das Skript selbst.'> +<!ENTITY sm.uidcheck.dir 'Ãberprüft ob das Verzeichnis in dem das Skript +ausgeführt werden soll, die gleiche UID (Eigentümer) hat wie das Skript selbst.'> <!ENTITY sm.disabled 'Diese Funktion steht im <link -linkend="features.safe-mode">Safe Mode</link> nicht zur Verfügung.'> +linkend="features.safe-mode">Safe Mode</link> nicht zur Verfügung.'> <!-- Common pieces in partintro-sections --> <!ENTITY no.config '<para>Diese Erweiterung definiert keine Konfigurationseinstellungen in der &php.ini;.</para>'> <!ENTITY no.resource '<para>Diese Erweiterung definiert keine Resource-Typen.</para>'> <!ENTITY no.constants '<para>Diese Erweiterung definiert keine Konstanten.</para>'> -<!ENTITY no.requirement '<para>Diese Erweiterung benötigt keine externen Bibliotheken.</para>'> -<!ENTITY no.install '<para>Für diese Funktionen ist keine Installation erforderlich, -diese gehören zum Grundbestand von PHP.</para>'> +<!ENTITY no.requirement '<para>Diese Erweiterung benötigt keine externen Bibliotheken.</para>'> +<!ENTITY no.install '<para>Für diese Funktionen ist keine Installation erforderlich, +diese gehören zum Grundbestand von PHP.</para>'> <!-- Used in every chapter that has directive descriptions --> -<!ENTITY ini.descriptions.title '<para>Hier eine kurze Erklärung der +<!ENTITY ini.descriptions.title '<para>Hier eine kurze Erklärung der Konfigurationsoptionen:</para>'> <!-- Common pieces for reference part BEGIN--> @@ -449,31 +449,31 @@ <!-- Used in reference/$extname/constants.xml --> <!ENTITY extension.constants '<simpara>Folgende Konstanten werden von dieser -Erweiterung definiert und stehen nur zur Verfügung, wenn die Erweiterung entweder +Erweiterung definiert und stehen nur zur Verfügung, wenn die Erweiterung entweder statisch in PHP kompiliert oder dynamisch zur Laufzeit geladen wurde. </simpara>'> <!-- For STANDARD Constants used in reference/$extname/constants.xml --> <!ENTITY extension.constants.core '<simpara>Die aufgelisteten Konstanten -stehen immer zur Verfügung, da sie zum Grundbestand von PHP gehören.</simpara>'> +stehen immer zur Verfügung, da sie zum Grundbestand von PHP gehören.</simpara>'> <!-- Used in reference/$extname/classes.xml --> <!ENTITY extension.classes '<simpara>Folgende Klassen werden von dieser -Erweiterung definiert und stehen nur zur Verfügung, wenn die Erweiterung +Erweiterung definiert und stehen nur zur Verfügung, wenn die Erweiterung entweder statisch in PHP kompiliert oder dynamisch zur Laufzeit geladen wurde. </simpara>'> -<!ENTITY note.extension.php5 '<note><simpara> Diese Erweiterung benötigt +<!ENTITY note.extension.php5 '<note><simpara> Diese Erweiterung benötigt PHP 5.</simpara></note>'> <!-- PDO entities --> <!ENTITY pdo.driver-constants '<simpara>Die folgenden Konstanten werden vom Treiber -definiert und sind nur verfügbar wenn die Extension entweder in PHP einkompiliert -oder dynamisch zur Laufzeit geladen wurde. Weiterhin sind diese Konstanten +definiert und sind nur verfügbar wenn die Extension entweder in PHP einkompiliert +oder dynamisch zur Laufzeit geladen wurde. Weiterhin sind diese Konstanten treiberspezifisch und sollten nur mit diesem Treiber benutzt werden. MySQL-spezifische Attribute mit dem PostgreSQL Treiber zu nutzen kann zu unerwarteten Ergebnissen -führen. Kann Ihr Code mit verschiedenen Treibern arbeiten so können Sie -<function>PDO::getAttribute</function> benutzen um mit +führen. Kann Ihr Code mit verschiedenen Treibern arbeiten so können Sie +<function>PDO::getAttribute</function> benutzen um mit <constant>PDO_ATTR_DRIVER_NAME</constant> den aktuellen Treiber zu ermitteln. </simpara>'> @@ -484,40 +484,40 @@ <!ENTITY pecl.bundled 'Diese <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl;">PECL</link> Erweiterung ist Teil von PHP.'> -<!ENTITY pecl.info 'Information zur Installation dieser PECL Extension +<!ENTITY pecl.info 'Information zur Installation dieser PECL Extension finden sie im Kapitel <link linkend="install.pecl">Installation von PECL Extensions</link>. -Zusätzliche Informationen, wie neue Releases, Downloads +Zusätzliche Informationen, wie neue Releases, Downloads Quelldateien, Maintainerinformation und ein CHANGELOG finden Sie hier: '> -<!ENTITY pecl.source.4 'Für PHP 4 finden Sie die Quellen dieser +<!ENTITY pecl.source.4 'Für PHP 4 finden Sie die Quellen dieser <acronym>PECL</acronym> Erweiterung im <filename>ext/</filename> Verzeichnis innerhalb der PHP Quellen oder unter dem <acronym>PECL</acronym> Link wie oben angegeben.'> -<!ENTITY pecl.windows.4 'Für PHP 4 finden Sie die <acronym>DLL</acronym> im -<filename>extensions/</filename> Verzeichnis der PHP Windows Binärdistribution.'> +<!ENTITY pecl.windows.4 'Für PHP 4 finden Sie die <acronym>DLL</acronym> im +<filename>extensions/</filename> Verzeichnis der PHP Windows Binärdistribution.'> -<!ENTITY pecl.windows.download ' Sie können die <acronym>DLL</acronym> für +<!ENTITY pecl.windows.download ' Sie können die <acronym>DLL</acronym> für diese <acronym>PECL</acronym> Erweiterung entweder von <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.php.downloads;">PHP Downloads</link> oder von <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl.win;">&url.pecl.win;</link> herunterladen.'> -<!ENTITY pecl.windows.download.unbundled 'Einzelne <acronym>PECL</acronym> Extensions können von -den <acronym>PECL</acronym> Schnappschussseiten heruntergeladen werden (wählen Sie das geeignete -Repository für <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl.win;">&url.pecl.win;</link>'> +<!ENTITY pecl.windows.download.unbundled 'Einzelne <acronym>PECL</acronym> Extensions können von +den <acronym>PECL</acronym> Schnappschussseiten heruntergeladen werden (wählen Sie das geeignete +Repository für <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl.win;">&url.pecl.win;</link>'> -<!ENTITY pecl.moved-ver 'Diese Erweiterung wurde ins <link xmlns:xlink="http://www.w3.org/1999/xlink" +<!ENTITY pecl.moved-ver 'Diese Erweiterung wurde ins <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl;">PECL</link> Repositorium verschoben und ist nicht mehr Teil von PHP ab PHP '> <!-- kept for BC --> <!ENTITY note.pecl-php5 '<note><simpara> Diese Erweiterung wurde aus der Distribution von PHP 5 entfernt und steht in -<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl;">PECL</link> zur Verfügung.</simpara></note>'> +<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl;">PECL</link> zur Verfügung.</simpara></note>'> <!-- Common pieces for reference part END --> -<!ENTITY windows.builtin '<simpara>Die Windowsversion von PHP enthält diese -Erweiterung. Um diese Funktionen zu verwenden, müssen Sie keine zusätzlichen +<!ENTITY windows.builtin '<simpara>Die Windowsversion von PHP enthält diese +Erweiterung. Um diese Funktionen zu verwenden, müssen Sie keine zusätzlichen Erweiterungen aktivieren.</simpara>'> <!-- These are here as helpers for manual consistency and brievety--> @@ -530,111 +530,111 @@ debug_level</parameter></term><listitem><para>Ein aus der Addition von <literal>XXX_TRACE</literal> Konstanten gewonnener Integerwert.</para> <para>. Von der Verwendung der <constant>MEMORY_TRACE</constant> Konstante -wird abgeraten da diese die Ausführung sehr verlangsamt und keine genauen +wird abgeraten da diese die Ausführung sehr verlangsamt und keine genauen Ergebnisse zu liefern scheint. <constant>ASSIGNMENT_TRACE</constant> ist -noch nicht implementiert.</para><para>Um alle funktioierenden Traces -(TIMING, FUNCTIONS, ARGS SUMMARY (ähnlich zu strace -c)) zu aktivieren +noch nicht implementiert.</para><para>Um alle funktioierenden Traces +(TIMING, FUNCTIONS, ARGS SUMMARY (ähnlich zu strace -c)) zu aktivieren benutzen Sie den Wert 99</para></listitem></varlistentry>'> <!-- BCMath Notes --> <!ENTITY bc.scale.description '<varlistentry><term><parameter> scale</parameter></term><listitem><para>Dieser optionale Parameter kann benutzt werden um die Anzahl der Nachkommastellen im Ergebnis -festzulegen. Sie können mit Hilfe der <function>bcscale</function> -Funktion auch einen globalen Vorgabewert für alle Funktionen +festzulegen. Sie können mit Hilfe der <function>bcscale</function> +Funktion auch einen globalen Vorgabewert für alle Funktionen festlegen.</para></listitem></varlistentry>'> <!-- FBSQL Notes --> <!ENTITY fbsql.link-identifier.description '<varlistentry><term><parameter> -link_identifier</parameter></term><listitem><para>Eine von +link_identifier</parameter></term><listitem><para>Eine von <function>fbsql_connect</function> oder <function>fbsql_pconnect</function> -zurückgegebe FrontBase-Verbindung.</para><para>Wenn optional und nicht -angegeben wird versucht eine bereits geöffnete FrontBase Verbindung gesucht, -falls keine vorhanden ist wird versucht eine zu öffnen als ob +zurückgegebe FrontBase-Verbindung.</para><para>Wenn optional und nicht +angegeben wird versucht eine bereits geöffnete FrontBase Verbindung gesucht, +falls keine vorhanden ist wird versucht eine zu öffnen als ob <function>fbsql_connect</function> ohne Parameter aufgerufen wurde </para></listitem></varlistentry>'> - + <!ENTITY fbsql.result.description '<varlistentry><term><parameter> result</parameter></term><listitem><para>Ein von <function>fbsql_query</function> -zurückgegebenes Erebnishandle.</para></listitem></varlistentry>'> +zurückgegebenes Erebnishandle.</para></listitem></varlistentry>'> <!-- GMP Notes --> -<!ENTITY gmp.return 'Eine <type>resource</type> für einen GMP Wert.'> +<!ENTITY gmp.return 'Eine <type>resource</type> für einen GMP Wert.'> <!ENTITY gmp.parameter '<para>Dies kann entweder eine <type>resource</type> -für einen GMP Wert sein oder ein numerischer String wenn es möglich ist +für einen GMP Wert sein oder ein numerischer String wenn es möglich ist diesen in einen GMP Wert umzuwandeln.</para>'> - + <!-- MySQLi Notes --> <!ENTITY mysqli.result.description '<varlistentry><term><parameter> result</parameter></term><listitem><para>Nur bei prozeduralem Aufruf: Ein von <function>mysqli_query</function>, <function>mysqli_store_result</function> -oder <function>mysqli_use_result</function> zurückgegebenes Ergebnisobjekt. +oder <function>mysqli_use_result</function> zurückgegebenes Ergebnisobjekt. </para></listitem></varlistentry>'> <!ENTITY mysqli.link.description '<varlistentry><term><parameter> link</parameter></term><listitem><para>Nur bei prozeduralem Aufruf: Ein von <function>mysqli_connect</function> oder <function>mysqli_init</function> -zurückgegebenes Verbindungsobjekt.</para></listitem></varlistentry>'> +zurückgegebenes Verbindungsobjekt.</para></listitem></varlistentry>'> <!ENTITY mysqli.stmt.description '<varlistentry><term><parameter> stmt</parameter></term><listitem><para>Nur bei prozeduralem Aufruf: ein von -<function>mysqli_stmt_init</function> zurückgegebens Statementobjekt.</para> +<function>mysqli_stmt_init</function> zurückgegebens Statementobjekt.</para> </listitem></varlistentry>'> <!-- Notes for SAPI/Apache --> -<!ENTITY note.apache.nsapi-module '<note><para>Ab PHP 4.3.3 können Sie diese -Funktion auch mit dem <link linkend="ref.nsapi">NSAPI Server Modul</link> für +<!ENTITY note.apache.nsapi-module '<note><para>Ab PHP 4.3.3 können Sie diese +Funktion auch mit dem <link linkend="ref.nsapi">NSAPI Server Modul</link> für Netscape/iPlanet/SunONE Webserver nutzen.</para></note>'> -<!ENTITY apache.req.module '<simpara>Diese Funktion wird nur unterstützt, wenn +<!ENTITY apache.req.module '<simpara>Diese Funktion wird nur unterstützt, wenn PHP als Apache-Modul installiert wurde.</simpara>'> <!-- SimpleXML Notes --> -<!ENTITY simplexml.iteration '<note><simpara>SimpleXML definiert für die -meisten Methoden Regeln für das Hinzufügen von iterativen Eigenschaften. Diese -können weder mit <function>var_dump</function> oder auf andere Weise angezeigt +<!ENTITY simplexml.iteration '<note><simpara>SimpleXML definiert für die +meisten Methoden Regeln für das Hinzufügen von iterativen Eigenschaften. Diese +können weder mit <function>var_dump</function> oder auf andere Weise angezeigt werden.</simpara></note>'> <!-- SQLite Notes --> -<!ENTITY sqlite.case-fold '<para>Die Groß- und Kleinschreibung der +<!ENTITY sqlite.case-fold '<para>Die GroÃ- und Kleinschreibung der Spaltennamen, die von <literal>SQLITE_ASSOC</literal> und -<literal>SQLITE_BOTH</literal> zurückgegeben werden, wird entsprechend der +<literal>SQLITE_BOTH</literal> zurückgegeben werden, wird entsprechend der Konfigurationsdirektive <link -linkend="ini.sqlite.assoc-case">sqlite.assoc_case</link> geändert.</para>'> +linkend="ini.sqlite.assoc-case">sqlite.assoc_case</link> geändert.</para>'> <!ENTITY sqlite.decode-bin '<para>Falls der Parameter <parameter>decode_binary</parameter> auf &true; gesetzt ist (das ist die -Standardeinstellung), dekodiert PHP die Binärkodierung, die bei Verwendung von +Standardeinstellung), dekodiert PHP die Binärkodierung, die bei Verwendung von <function>sqlite_escape_string</function> auf die Daten angewendet wird. -Solange Sie die Daten nicht mit anderen SQLite-Fähigen Applikationen teilen, +Solange Sie die Daten nicht mit anderen SQLite-Fähigen Applikationen teilen, sollten Sie diesen Wert in der Standardeinstellung lassen.</para>'> <!ENTITY sqlite.no-unbuffered '<note><para>Diese Funktion kann nicht mit ungepufferten Ergebnishandlern benutzt werden.</para></note>'> <!ENTITY sqlite.param-compat '<note><simpara>Zwei alternative Syntaxen werden -für die Kompatibilität mit anderen Datenbank-Erweiterungen (wie z.B. MySQL) -unterstützt. Die bevorzugte Form ist die erste, bei der der Parameter +für die Kompatibilität mit anderen Datenbank-Erweiterungen (wie z.B. MySQL) +unterstützt. Die bevorzugte Form ist die erste, bei der der Parameter <parameter>dbhandle</parameter> der erste Parameter der Funktion ist.</simpara></note>'> <!ENTITY sqlite.result-type '<para>Der optionale Parameter <parameter>Ergebnis_Typ</parameter> akzeptiert eine Konstante und bestimmt, -wie das zurückgegebene Array indiziert wird. Während mit +wie das zurückgegebene Array indiziert wird. Während mit <constant>SQLITE_ASSOC</constant> nur assoziative Indizes (Namensfelder) -zurückgegeben werden, werden mit <constant>SQLITE_NUM</constant> nur -numerische Indizes (geordnete Feldnummern) zurückgegeben. +zurückgegeben werden, werden mit <constant>SQLITE_NUM</constant> nur +numerische Indizes (geordnete Feldnummern) zurückgegeben. <constant>SQLITE_BOTH</constant> gibt sowohl assoziative als auch numerische -Indizes zurück. <constant>SQLITE_BOTH</constant> ist die +Indizes zurück. <constant>SQLITE_BOTH</constant> ist die Standardeinstellung.</para>'> <!-- Database Notes --> <!ENTITY database.field-case '<note><simpara>Feldnamen, die von dieser Funktion -zurückgegeben werden, unterscheiden sich in der -<emphasis>Groß-/Kleinschreibung</emphasis>.</simpara></note>'> +zurückgegeben werden, unterscheiden sich in der +<emphasis>GroÃ-/Kleinschreibung</emphasis>.</simpara></note>'> <!ENTITY database.fetch-null '<note><simpara>Diese Funktion setzt NULL Felder auf den PHP Wert &null;.</simpara></note>'> @@ -644,9 +644,9 @@ <!ENTITY msql.linkid.description '<varlistentry><term><parameter> Verbindungskennung</parameter></term><listitem><para>Die mSQL-Verbindung. Wird keine Verbindungskennung angegeben, wird die letzte durch -<function>msql_connect</function> geöffnete Verbindung angenommen. Falls +<function>msql_connect</function> geöffnete Verbindung angenommen. Falls keine solche Verbindung gefunden wird, versucht die Funktion, eine Verbindung -so aufzubauen, als wäre <function>msql_connect</function> aufgerufen worden +so aufzubauen, als wäre <function>msql_connect</function> aufgerufen worden und verwendet diese.</para></listitem></varlistentry>'> <!ENTITY msql.result.description '<varlistentry><term><parameter> @@ -665,10 +665,10 @@ <!ENTITY mysql.linkid.description '<varlistentry><term><parameter> Verbindungs-Kennung</parameter></term><listitem><para>Die MySQL-Verbindung. Wird die Verbindungskennung nicht angegeben, wird die letzte durch -<function>mysql_connect</function> geöffnete Verbindung angenommen. Falls +<function>mysql_connect</function> geöffnete Verbindung angenommen. Falls keine solche Verbindung gefunden wird, wird versucht, eine Verbindung aufzubauen, wie es beim Aufruf von <function>mysql_connect</function> ohne -Angabe von Argumenten der Fall wäre. Falls zufällig keine Verbindung gefunden +Angabe von Argumenten der Fall wäre. Falls zufällig keine Verbindung gefunden oder aufgebaut werden kann, wird eine Warnung der Stufe <constant>E_WARNING</constant> erzeugt.</para></listitem></varlistentry>'> @@ -685,115 +685,115 @@ <constant>E_WARNING</constant> erzeugt.</para></listitem></varlistentry>'> <!-- Sybase Notes --> -<!ENTITY sybase.ct.only '<note><simpara>Diese Funktion steht nur zur Verfügung, +<!ENTITY sybase.ct.only '<note><simpara>Diese Funktion steht nur zur Verfügung, wenn Sie die CT Bibliothek als Schnittstelle zu Sybase verwenden. </simpara></note>'> -<!ENTITY sybase.db.only '<note><simpara>Diese Funktion steht nur zur Verfügung, +<!ENTITY sybase.db.only '<note><simpara>Diese Funktion steht nur zur Verfügung, wenn Sie die DB Bibliothek als Schnittstelle zu Sybase verwenden.</simpara></note>'> <!ENTITY sybase.linkid.description '<varlistentry><term><parameter> link_identifier</parameter></term><listitem><para>Die Sybase Verbindung. -Wird keine Verbindung angegeben so wird die letzte mit -<function>sybase_connect</function> geöffnete Verbindung angenommen. +Wird keine Verbindung angegeben so wird die letzte mit +<function>sybase_connect</function> geöffnete Verbindung angenommen. Wird keine solche Verbindung gefunden wird versucht eine Verbindung -so zu öffnen als ob <function>sybase_connect</function> ohne Parameter -aufgerufen wurde. Kann keine Verbindung gefunden oder geöffnet werden +so zu öffnen als ob <function>sybase_connect</function> ohne Parameter +aufgerufen wurde. Kann keine Verbindung gefunden oder geöffnet werden so wird eine <constant>E_WARNING</constant> Warnung generiert.</para></listitem> </varlistentry>'> <!-- CPDF Notes --> <!ENTITY cpdf.ul '<para>Der optionale Parameter <parameter>mode</parameter> -bestimmt die Länge der Einheit. Ist dieser gleich 0 oder nicht angegeben, -wird die Standardeinheit benutzt die für die Seite angegeben wurde. +bestimmt die Länge der Einheit. Ist dieser gleich 0 oder nicht angegeben, +wird die Standardeinheit benutzt die für die Seite angegeben wurde. Andernfalls werden die Koordinaten in Postscript Punkten ohne Beachtung der aktuellen Einheit gemessen.</para>'> <!ENTITY cpdf.mode.description '<varlistentry><term><parameter> mode</parameter></term><listitem><para>Der optionale Parameter <parameter>mode</parameter> bestimmt die Masseinheit. Wenn er -0 ist oder nicht übergeben wurde wird die Standardmaßeinheit des -Dokuments benutzt, ansonsten werden Koordinaten in PostScript -Punkten gemessen und die Standardmaßeinheit ignoriert. +0 ist oder nicht übergeben wurde wird die StandardmaÃeinheit des +Dokuments benutzt, ansonsten werden Koordinaten in PostScript +Punkten gemessen und die StandardmaÃeinheit ignoriert. </para></listitem></varlistentry>'> - + <!ENTITY cpdf.pdf-document.description '<varlistentry><term><parameter> -pdf_document</parameter></term><listitem><para>Das von +pdf_document</parameter></term><listitem><para>Das von <function>cpdf_open</function> gelieferte Dokument-Handle.</para> </listitem></varlistentry>'> <!-- Xattr entities --> <!ENTITY xattr.namespace '<para>Erweiterte Eigenschaften haben zwei -verschiedene Namensräume: den User- und den Root-Namensraum. Der -User-Namensraum steht allen Benutzern zur Verfügung während der -Root-Namensraum nur Benutzern mit Root-Rechten zur Verfügung steht. xattr -operiert standardmäßig im User-Namensraum, aber das können Sie mit dem -Parameter <parameter>flags</parameter> ändern.</para>'> +verschiedene Namensräume: den User- und den Root-Namensraum. Der +User-Namensraum steht allen Benutzern zur Verfügung während der +Root-Namensraum nur Benutzern mit Root-Rechten zur Verfügung steht. xattr +operiert standardmäÃig im User-Namensraum, aber das können Sie mit dem +Parameter <parameter>flags</parameter> ändern.</para>'> <!-- Notes for IPv6 --> <!ENTITY ipv6.brackets '<note><simpara>Wenn Sie eine numerische IPv6 Adresse -angeben, z.B.: <literal>fe80::1</literal>, müssen Sie die IP in eckige Klammern +angeben, z.B.: <literal>fe80::1</literal>, müssen Sie die IP in eckige Klammern schreiben, z.B: <literal>tcp://[fe80::1]:80</literal>.</simpara></note>'> -<!ENTITY ipv6.php5 '<note><simpara>IPv6 Unterstützung steht seit PHP 5.0.0 zur -Verfügung.</simpara></note>'> +<!ENTITY ipv6.php5 '<note><simpara>IPv6 Unterstützung steht seit PHP 5.0.0 zur +Verfügung.</simpara></note>'> <!-- Notes for tidy --> <!ENTITY note.tidy.ze2 '<note><simpara> Diese Funktion wird nur von der Zend -Engine 2 (PHP >= 5.0.0) unterstützt.</simpara></note>'> +Engine 2 (PHP >= 5.0.0) unterstützt.</simpara></note>'> <!ENTITY note.tidy.1only '<note><simpara>Diese Funktion steht nur in Tidy 1.0 -zur Verfügung. In Tidy 2.0 ist diese Funktion obsolet und wurde entfernt. +zur Verfügung. In Tidy 2.0 ist diese Funktion obsolet und wurde entfernt. </simpara></note>'> <!ENTITY note.tidy.2only '<note><simpara>Die optionalen Parameter <parameter>config</parameter> und <parameter>encoding</parameter> stehen seit -Tidy 2.0 zur Verfügung.</simpara></note>'> +Tidy 2.0 zur Verfügung.</simpara></note>'> <!ENTITY tidy.conf-enc '<para>Den <parameter>config</parameter> Parameter -können Sie entweder als Array oder String übergeben. Bei der Übergabe als +können Sie entweder als Array oder String übergeben. Bei der Ãbergabe als String wird dieser als Name der Konfigurationsdatei interpretiert, bei der -Übergabe als Array als die Optionen selbst. Für möegliche Optionen und deren +Ãbergabe als Array als die Optionen selbst. Für möegliche Optionen und deren Bedeutung sollten Sie sich <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.tidy.conf;">&url.tidy.conf;</link> anschauen.</para><para>Der <parameter>encoding</parameter> Parameter bestimmt -die Kodierung für die Ein- und Ausgabe von Dokumenten. Mögliche Werte für -<parameter>encoding</parameter>: <literal>ascii</literal>, <literal>latin0</literal>, -<literal>latin1</literal>, <literal>raw</literal>, <literal>utf8</literal>, -<literal>iso2022</literal>, <literal>mac</literal>, <literal>win1252</literal>, -<literal>ibm858</literal>, <literal>utf16</literal>, <literal>utf16le</literal>, -<literal>utf16be</literal>, <literal>big5</literal> und +die Kodierung für die Ein- und Ausgabe von Dokumenten. Mögliche Werte für +<parameter>encoding</parameter>: <literal>ascii</literal>, <literal>latin0</literal>, +<literal>latin1</literal>, <literal>raw</literal>, <literal>utf8</literal>, +<literal>iso2022</literal>, <literal>mac</literal>, <literal>win1252</literal>, +<literal>ibm858</literal>, <literal>utf16</literal>, <literal>utf16le</literal>, +<literal>utf16be</literal>, <literal>big5</literal> und <literal>shiftjis</literal>.</para>'> <!-- Snippets for the installation section --> <!ENTITY warn.apache2.compat '<warning><para>Wir empfehlen, in einer Produktionsumgebung kein Threaded MPM mit Apache2 zu verwenden. Verwenden Sie -stattdessen das Prefork MPM oder Apache1. Für weitere Informationen und die -Gründe lesen Sie bitte den entsprechenden FAQ-Eintrag über die Verwendung von +stattdessen das Prefork MPM oder Apache1. Für weitere Informationen und die +Gründe lesen Sie bitte den entsprechenden FAQ-Eintrag über die Verwendung von <link linkend="faq.installation.apache2">Apache2 mit Threaded MPM.</link></para></warning>'> <!ENTITY note.apache.slashes '<note><simpara>Beachten Sie bitte, dass Sie bei Pfadangaben in der Apachekonfigurationsdatei unter Windows alle Backslashes, -wie z.B. <filename>c:\directory\file.ext</filename>, in Schrägstriche umwandeln -müssen: <filename>c:/directory/file.ext</filename>. Bei Verzeichnisnamen -kann weiterhin ein abschließender Schrägstrich nötig sein.</simpara></note>'> +wie z.B. <filename>c:\directory\file.ext</filename>, in Schrägstriche umwandeln +müssen: <filename>c:/directory/file.ext</filename>. Bei Verzeichnisnamen +kann weiterhin ein abschlieÃender Schrägstrich nötig sein.</simpara></note>'> <!-- Snippets and titles for the contributors section --> <!ENTITY Credit.Authors.and.Contributors 'Autoren und Mitwirkende'> <!ENTITY Credit.Introduction '<para>Wir heben die zur Zeit aktivsten Personen auf der Titelseite des Handbuchs hervor, aber es gibt viel mehr Mitwirkende, -die zurzeit mithelfen oder in der Vergangenheit einen großen Beitrag zu diesem +die zurzeit mithelfen oder in der Vergangenheit einen groÃen Beitrag zu diesem Projekt geleistet haben. Ebenfalls gibt es eine Vielzahl von Personen, die hier -nicht namentlich aufgeführt sind, die durch ihre User Notes auf den +nicht namentlich aufgeführt sind, die durch ihre User Notes auf den Handbuchseiten mithelfen. Die User Notes werden kontinuierlich in unser -Handbuch integriert und wir schätzen diese Unterstützung außerordentlich. +Handbuch integriert und wir schätzen diese Unterstützung auÃerordentlich. Alle folgenden Listen sind alphabetisch sortiert.</para>'> <!ENTITY Credit.Authors.and.Editors 'Autoren und Editoren'> <!ENTITY Credit.Past.Authors.Text 'Folgende Personen verdienenen Anerkennung -dafür, dass Sie wesentlichen Inhalt zum Handbuch beigetragen haben und/oder weiterhin +dafür, dass Sie wesentlichen Inhalt zum Handbuch beigetragen haben und/oder weiterhin beitragen werden:'> <!ENTITY Credit.Past.Editors.Text 'Folgende Personen haben @@ -804,7 +804,7 @@ <!ENTITY Credit.Note.Editors.Active 'Die zurzeit aktivsten Betreuer:'> <!ENTITY Credit.Note.Editors.Inactive 'Auch folgende Personen haben -einiges an Mühe und Zeit zur Betreuung der User Notes investiert:'> +einiges an Mühe und Zeit zur Betreuung der User Notes investiert:'> <!ENTITY listendand ' und'> @@ -814,40 +814,40 @@ method.</simpara></note>'> <!ENTITY note.runkit.selfmanipulation '<note><simpara> Diese Funktion kann nicht -genutzt werden um die aktuell ausgeführte (oder verkette) Methode zu manipulieren. +genutzt werden um die aktuell ausgeführte (oder verkette) Methode zu manipulieren. </simpara></note>'> -<!ENTITY note.runkit.sandbox '<note><simpara>Sandbox Unterstützung -(wird benötigt für <function>runkit_lint</function>, <function>runkit_lint_file</function>, -und die <classname>Runkit_Sandbox</classname> Klasse) ist nur ab PHP 5.1 +<!ENTITY note.runkit.sandbox '<note><simpara>Sandbox Unterstützung +(wird benötigt für <function>runkit_lint</function>, <function>runkit_lint_file</function>, +und die <classname>Runkit_Sandbox</classname> Klasse) ist nur ab PHP 5.1 und speziell gepatchten Versionen -von PHP 5.0 verfügbar und setzt voraus das Thread-Unterstützung aktiviert wurde. -Weiterführende Informationen finden sie in der README Datei des runkit Packets. +von PHP 5.0 verfügbar und setzt voraus das Thread-Unterstützung aktiviert wurde. +Weiterführende Informationen finden sie in der README Datei des runkit Packets. See the README file included in the runkit package for more information. </simpara></note>'> -<!ENTITY note.runkit.internal-override '<note><simpara>Normalerweise können -nur benutzerdefinierte Funktionen gelöscht, umbenannt oder modifiziert werden. -Wenn Sie auch interne Funktionen übersteuern wollen müssen Sie +<!ENTITY note.runkit.internal-override '<note><simpara>Normalerweise können +nur benutzerdefinierte Funktionen gelöscht, umbenannt oder modifiziert werden. +Wenn Sie auch interne Funktionen übersteuern wollen müssen Sie <literal>runkit.internal_override</literal> in Ihrer &php.ini; aktivieren.</simpara></note>'> <!-- SSH2 Extension --> <!ENTITY note.ssh2.subsystem.publickey '<note><simpara> -Das Publickey Subsystem wird benötigt um öffentliche Schlüssel -auf einem Server zu verwalten für welche der Client -<emphasis>bereits authentifiziert ist</emphasis>. -Sie können sich gegenüber einem anderen System mit Publickey -Authentifizierung authentifizieren indem sie die +Das Publickey Subsystem wird benötigt um öffentliche Schlüssel +auf einem Server zu verwalten für welche der Client +<emphasis>bereits authentifiziert ist</emphasis>. +Sie können sich gegenüber einem anderen System mit Publickey +Authentifizierung authentifizieren indem sie die <function>ssh2_auth_pubkey_file</function> nutzen. </simpara></note>'> <!-- HTTP --> -<!ENTITY see.http.request.options '<para>Siehe auch die vollständige Liste der +<!ENTITY see.http.request.options '<para>Siehe auch die vollständige Liste der &link.http.request.options;.</para>'> - -<!ENTITY see.http.configuration.force_exit '&link.http.configuration; beschreibt was "beendet" in + +<!ENTITY see.http.configuration.force_exit '&link.http.configuration; beschreibt was "beendet" in diesem Zusammenhang bedeutet.'> <!ENTITY link.http.configuration '<link linkend="http.configuration">INI Einstellungen</link>'> @@ -858,7 +858,7 @@ <!ENTITY link.http.request.info '<link linkend="http.request.info">Request/Response Information</link>'> -<!ENTITY returns.http.response 'Gibt die HTTP Antwort(en) als String zurück oder &false; bei Fehlern.'> +<!ENTITY returns.http.response 'Gibt die HTTP Antwort(en) als String zurück oder &false; bei Fehlern.'> <!ENTITY returns.http.false.orexits 'Liefert &false; oder <emphasis>beendet</emphasis> bei Erfolg'> @@ -867,13 +867,13 @@ <!ENTITY http.request.affects.any 'Beeinflusst alle Requestmethoden.'> <!ENTITY http.response.class.php51 'die <link linkend="class.httpresponse"><classname ->HttpResponse</classname></link> Klasse wenn sie PHP 5.1 oder höher benutzen'> +>HttpResponse</classname></link> Klasse wenn sie PHP 5.1 oder höher benutzen'> -<!ENTITY http.maynotwork.SAPI 'Mit den folgenden SAPIs funktioniert dies evtl. nicht wie erwartet:This may not work as expected with the following SAPI(s):'> +<!ENTITY http.maynotwork.SAPI 'Mit den folgenden SAPIs funktioniert dies evtl. nicht wie erwartet:'> <!ENTITY http.content.disposition 'Der <literal>Content-Disposition</literal> ist hilfreich -wenn die gesendeten aus einer Datei oder einer ähnlichen Quelle stammen und vom Benutzer -oder Klienten gespeichert werden sollen (z.B. über den "Save as..." Dialog +wenn die gesendeten aus einer Datei oder einer ähnlichen Quelle stammen und vom Benutzer +oder Klienten gespeichert werden sollen (z.B. über den "Save as..." Dialog des Browsers).'> <!ENTITY http.use.ob_start 'Zur Nutzung mit <function>ob_start</function>.'> @@ -883,19 +883,19 @@ werden neu berechnet oder definiert.</simpara></note>'> <!ENTITY note.http.throttling.yields.process '<note><simpara>Stellt einen einfachen -Drosselungsmechanismus zur Verfügung der den aktuellen Prozess oder Thread stillegt -bis die Daten vollständig gesendet wurden.</simpara></note>'> +Drosselungsmechanismus zur Verfügung der den aktuellen Prozess oder Thread stillegt +bis die Daten vollständig gesendet wurden.</simpara></note>'> -<!ENTITY note.http.send.API '<note><simpara>Diese Funktion sollte zusammen mit -<function>http_send_data</function>, <function>http_send_file</function> +<!ENTITY note.http.send.API '<note><simpara>Diese Funktion sollte zusammen mit +<function>http_send_data</function>, <function>http_send_file</function> &listendand; <function>http_send_stream</function> benutzt werden.</simpara></note>'> <!ENTITY note.http.send.API.mayuse '<note><simpara>Diese Funktion kann zusammen mit -<function>http_send_data</function>, <function>http_send_file</function> +<function>http_send_data</function>, <function>http_send_file</function> &listendand; <function>http_send_stream</function> benutzt werden.</simpara></note>'> -<!ENTITY note.http.request.encodecookies '<note><simpara>Die &link.http.request.option; <literal>encodecookies</literal> +<!ENTITY note.http.request.encodecookies '<note><simpara>Die &link.http.request.option; <literal>encodecookies</literal> legt fest ob der Cookie-Wert mit <function>urlencode</function> kodiert werden soll..</simpara></note>'> <!ENTITY note.http.request.affects.any '<note><simpara>&http.request.affects.any;</simpara></note>'> @@ -904,25 +904,25 @@ <!-- XMLWriter Notes --> <!ENTITY xmlwriter.xmlwriter.description '<varlistentry><term><parameter> -xmlwriter</parameter></term><listitem><para>Nur für prozedurale Aufrufe. +xmlwriter</parameter></term><listitem><para>Nur für prozedurale Aufrufe. Die XMLWriter <type>resource</type> die bearbeitet werden soll. Diese -Resource wird von Aufrufen von <function>xmlwriter_open_uri</function> +Resource wird von Aufrufen von <function>xmlwriter_open_uri</function> oder <function>xmlwriter_open_memory</function> geliefert. </para></listitem></varlistentry>'> <!-- SVN notes --> -<!ENTITY svn.relativepath "<note><simpara>Relative Pfade werden so aufgelöst als ob -das aktuelle Verzeichnis das wäre in dem sich das PHP Binary befindet. Um statt dessen -das aktuelle Verzeichnis des aufrufenden Skripts zu nutzen müssen sie die -<function>realpath</function> Funktion oder dirname(__FILE__) zur Hilfe +<!ENTITY svn.relativepath "<note><simpara>Relative Pfade werden so aufgelöst als ob +das aktuelle Verzeichnis das wäre in dem sich das PHP Binary befindet. Um statt dessen +das aktuelle Verzeichnis des aufrufenden Skripts zu nutzen müssen sie die +<function>realpath</function> Funktion oder dirname(__FILE__) zur Hilfe ziehen.</simpara></note>"> <!ENTITY svn.referto.status 'Siehe auch <link linkend="svn.constants.status" ->Status-Konstanten</link> für mögliche Werte.'> +>Status-Konstanten</link> für mögliche Werte.'> <!ENTITY svn.referto.type 'Siehe auch <link linkend="svn.constants.type" ->Type-Konstanten</link> für mögliche Werte.'> - +>Type-Konstanten</link> für mögliche Werte.'> + <!-- Imagick generic return types --> <!ENTITY imagick.return.success 'Liefet &true; bei Erfolg.'> @@ -937,34 +937,34 @@ <!ENTITY note.openssl.cnf '<note xmlns="http://docbook.org/ns/docbook"> <simpara> - Die ordnungsgemäße Ausführung dieser Funktion setzt die Installation - einer gültigen <filename>openssl.cnf</filename> Datei voraus. + Die ordnungsgemäÃe Ausführung dieser Funktion setzt die Installation + einer gültigen <filename>openssl.cnf</filename> Datei voraus. Mehr Information hierzu finden sie im <link linkend="openssl.installation" >Installationsabschnitt</link>. </simpara> </note>'> <!ENTITY note.openssl.param-notext '<para xmlns="http://docbook.org/ns/docbook"> - Der optionale Parameter<parameter>notext</parameter> beinflusst die - Ausführlichkeit der Ausgabe. Wenn er auf &false; gesetzt wird werden - zusätzliche lesbare Informationen in die Ausgabe aufgenommen. Der - Vorgabewert für <parameter>notext</parameter> ist &true;. + Der optionale Parameter<parameter>notext</parameter> beinflusst die + Ausführlichkeit der Ausgabe. Wenn er auf &false; gesetzt wird werden + zusätzliche lesbare Informationen in die Ausgabe aufgenommen. Der + Vorgabewert für <parameter>notext</parameter> ist &true;. </para>'> <!-- COM/Dotnet --> <!ENTITY com.variant-arith '<note xmlns="http://docbook.org/ns/docbook"> <para> - Wie bei allen arithmetischen Variantfunktionen können die Parameter dieser - Funktion entweder native PHP Typen (Integer, String, Fließkomma, Boolean + Wie bei allen arithmetischen Variantfunktionen können die Parameter dieser + Funktion entweder native PHP Typen (Integer, String, FlieÃkomma, Boolean oder &null;) oder Instanzen einer COM, VARIANT oder DOTNET Klasse sein. Native PHP Typen werden nach den gleichen Regeln in Varianten umgewandelt wie auch im Konstruktor der <xref linkend="class.variant"/> Klasse. - Für COM und DOTNET Objekte wird der Wert ihrer Standardeigenschaft + Für COM und DOTNET Objekte wird der Wert ihrer Standardeigenschaft genommen und als Variantenwert genutzt. </para> <para> - Die arithmetischen Variantenfunktionen sind Wrapper für die ähnlich - benannten Funktionen der COM Bibliothek, weiterführende Informationen + Die arithmetischen Variantenfunktionen sind Wrapper für die ähnlich + benannten Funktionen der COM Bibliothek, weiterführende Informationen hierzu finden sie in der MSDN Bibliothek. Die PHP Funktionen sind leicht abweichend benannt, so korrespondiert <function>variant_add</function> in PHP zu VarAdd() in der MSDN Dokumentation. @@ -975,8 +975,8 @@ <!ENTITY com.use-oo-instead '<note xmlns="http://docbook.org/ns/docbook"> <simpara> Diese Funktion existiert nicht in PHP 5. Sie sollten statt dessen die - reguläre und natürlichere OO Syntax für Zugriffe auf Properties und - für Methodenaufrufe benutzen. + reguläre und natürlichere OO Syntax für Zugriffe auf Properties und + für Methodenaufrufe benutzen. </simpara> </note> '> @@ -984,8 +984,8 @@ <!-- phar --> <!ENTITY phar.write '<note xmlns="http://docbook.org/ns/docbook"> <para> - Diese Methode des <classname>Phar</classname> Objekts funktioniert nur - wenn die &php.ini; Einstellung <literal>phar.readonly</literal> auf 0 + Diese Methode des <classname>Phar</classname> Objekts funktioniert nur + wenn die &php.ini; Einstellung <literal>phar.readonly</literal> auf 0 gesetzt ist, sonst wird eine <classname>PharException</classname> geworfen. </para> </note>
http://cvs.php.net/viewvc.cgi/phpdoc-de/language/functions.xml?r1=1.20&r2=1.21&diff_format=u Index: phpdoc-de/language/functions.xml diff -u phpdoc-de/language/functions.xml:1.20 phpdoc-de/language/functions.xml:1.21 --- phpdoc-de/language/functions.xml:1.20 Mon Jun 16 22:50:17 2008 +++ phpdoc-de/language/functions.xml Tue Jun 17 12:08:17 2008 @@ -1,17 +1,18 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.20 $ --> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.21 $ --> <!-- EN-Revision: 1.69 Maintainer: hholzgra Status: ready --> <!-- Credits: tom --> + <chapter xml:id="language.functions" xmlns="http://docbook.org/ns/docbook"> <title>Funktionen</title> <sect1 xml:id="functions.user-defined"> <title>Vom Nutzer definierte Funktionen</title> - + <para> Eine Funktion kann wie folgt definiert werden: </para> - + <para> <example> <title>Pseudokode zur Demonstration der Nutzung von Variablen</title> @@ -28,30 +29,30 @@ </programlisting> </example> </para> - + <simpara> Jeder beliebige korrekte PHP-Code kann in einer Funktion vorkommen, sogar andere Funktionen und <link - linkend="keyword.class">Klassen-</link> Definitionen. + linkend="keyword.class">Klassen</link>-Definitionen. </simpara> <para> - Für Funktionsnamen gelten in PHP die gleichen Regeln wie für - andere Bezeichner. Ein gültiger Funktionsname beginnt mit + Für Funktionsnamen gelten in PHP die gleichen Regeln wie für + andere Bezeichner. Ein gültiger Funktionsname beginnt mit einem Buchstaben oder Unterstrich gefolgt von einer beliebigen - Anzahl von Buchstaben, Ziffern und Unterstrichen. Als - regulärer Ausdruck wird dies so ausgedrückt: + Anzahl von Buchstaben, Ziffern und Unterstrichen. Als + regulärer Ausdruck wird dies so ausgedrückt: <literal>[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*</literal>. </para> &tip.userlandnaming; <simpara> - Es ist nicht erforderlich das Funktionen bereits definiert sein - müssen wenn auf sie verviesen wird, - <emphasis>außer</emphasis> wenn eine Funktion nur bedingt definiert + Es ist nicht erforderlich, dass Funktionen bereits definiert sein + müssen, wenn auf sie verviesen wird, + <emphasis>auÃer</emphasis> wenn eine Funktion nur bedingt definiert wird, wie in den beiden untenstehenden Beispielen gezeigt. </simpara> <para> Wenn eine Funktion nur unter bestimmten Bedingungen definiert wird, - muß die Definition dieser Funktion noch <emphasis>vor</emphasis> + muss die Definition dieser Funktion noch <emphasis>vor</emphasis> deren Aufruf abgearbeitet werden. <example> <title>Bedingte Funktionen</title> @@ -61,20 +62,20 @@ $makefoo = true; -/* Wir können foo() von her aus nicht +/* Wir können foo() von hier aus nicht aufrufen, da sie noch nicht existiert, - aber wir können bar() aufrufen */ + aber wir können bar() aufrufen */ bar(); if ($makefoo) { function foo () { - echo "Ich existiere nicht, bis mich die Programmausführung erreicht hat.\n"; + echo "Ich existiere nicht, bis mich die Programmausführung erreicht hat.\n"; } } -/* Nun können wir foo() sicher aufrufen, +/* Nun können wir foo() sicher aufrufen, da $makefoo als true ausgewertet wurde */ if ($makefoo) foo(); @@ -93,72 +94,71 @@ <programlisting role="php"> <![CDATA[ <?php -function foo() +function foo() { - function bar() + function bar() { echo "Ich existiere nicht, bis foo() aufgerufen wurde.\n"; } } -/* Wir können bar() noch nicht +/* Wir können bar() noch nicht aufrufen, da es nicht existiert */ foo(); -/* Nun können wir auch bar() aufrufen, +/* Nun können wir auch bar() aufrufen, da sie durch die Abarbeitung von - foo() verfügbar gemacht wurde */ + foo() verfügbar gemacht wurde */ bar(); -?> +?> ]]> </programlisting> </example> </para> <para> - Alle Funktionen und Klassen in PHP existieren im globalen Namensraum - - sie können außerhalb von Funktionen aufgerufen werden selbst wenn sie + Alle Funktionen und Klassen in PHP existieren im globalen Namensraum - + sie können auÃerhalb von Funktionen aufgerufen werden, selbst wenn sie innerhalb einer Funktion definiert wurden und umgekehrt. </para> <simpara> - PHP unterstützt weder das Überladen von Funktionen, noch ist es - möglich, zuvor deklarierte Funktionen neu zu definieren oder die - Definition zu löschen. + PHP unterstützt weder das Ãberladen von Funktionen, noch ist es + möglich, zuvor deklarierte Funktionen neu zu definieren oder die + Definition zu löschen. </simpara> <note> <simpara> - Groß- und Kleinschreibung spielt zwar bei Funktionsnamen keine + GroÃ- und Kleinschreibung spielt zwar bei Funktionsnamen keine Rolle, es empfiehlt sich aber trotzdem bei Funktionsaufrufen - die gleiche Schreibweise wie in der Deklaration zu benutzen. + die gleiche Schreibweise wie in der Deklaration zu benutzen. </simpara> </note> <simpara> - PHP 3 unterstützt keine variable Anzahl von Parametern, - obwohl Vorgabewerte für Parameter unterstützt werden + PHP 3 unterstützt keine variable Anzahl von Parametern, + obwohl Vorgabewerte für Parameter unterstützt werden (weitere Informationen finden Sie unter <link linkend="functions.arguments.default">Vorgabewerte - für Parameter</link>). Beginnend mit PHP 4 wird beides - unterstützt, - - Sowohl <link linkend="functions.variable-arg-list">eine - variable Anzahl Parameter</link> als auch + für Parameter</link>). Beginnend mit PHP 4 wird beides + unterstützt. + Sowohl <link linkend="functions.variable-arg-list">eine + variable Anzahl Parameter</link> als auch <link linkend="functions.arguments.default">Vorgabewerte - für Parameter</link> werden in Funktionen unterstützt. - Siehe auch die Funktionsreferenzen für + für Parameter</link> werden in Funktionen unterstützt. + Siehe auch die Funktionsreferenzen für <function>func_num_args</function>, <function>func_get_arg</function> und - <function>func_get_args</function> für weitere Informationen. + <function>func_get_args</function> für weitere Informationen. </simpara> <para> - Es ist in PHP möglich Funktionen rekursiv aufzurufen. + Es ist in PHP möglich, Funktionen rekursiv aufzurufen. Sie sollten aber rekursive Aufrufe mit einer Rekursionstiefe - von mehr als 100-200 vermeiden da diese zu einem Stacküberlauf - und damit zum Programmabbruch führen können. + von mehr als 100-200 vermeiden, da diese zu einem Stacküberlauf + und damit zum Programmabbruch führen können. <example> - <title>Recursive Functionen</title> + <title>Rekursive Funktionen</title> <programlisting role="php"> <![CDATA[ <?php @@ -175,34 +175,34 @@ </example> </para> </sect1> - + <sect1 xml:id="functions.arguments"> <title>Funktionsparameter</title> - + <simpara> - Mit einer Parameterliste kann man Informationen an eine Funktion - übergeben. Die Parameterliste ist eine durch Kommas getrennte - Liste von Ausdrücken. + Mit einer Parameterliste kann man Informationen an eine Funktion + übergeben. Die Parameterliste ist eine durch Kommas getrennte + Liste von Ausdrücken. </simpara> <para> - PHP unterstützt die Weitergabe von Parametern als Werte (das ist + PHP unterstützt die Weitergabe von Parametern als Werte (das ist der Standard), als <link - linkend="functions.arguments.by-reference">Verweise</link>, und + linkend="functions.arguments.by-reference">Verweise</link> und als <link linkend="functions.arguments.default">Vorgabewerte</link>. <link linkend="functions.variable-arg-list">Eine variable Anzahl - von Parametern</link> wird ebenfalls unterstützt, siehe auch die - Funktionsreferenzen für + von Parametern</link> wird ebenfalls unterstützt, siehe auch die + Funktionsreferenzen für <function>func_num_args</function>, <function>func_get_arg</function> und - <function>func_get_args</function> für weitere Informationen. + <function>func_get_args</function> für weitere Informationen. </para> <para> <example> - <title>Arrays an Funktionen übergeben</title> + <title>Arrays an Funktionen übergeben</title> <programlisting role="php"> <![CDATA[ ->?php +<?php function rechne_array($eingabe) { echo "$eingabe[0] + $eingabe[1] = ", $eingabe[0]+$eingabe[1]; @@ -212,27 +212,28 @@ </programlisting> </example> </para> - + <sect2 xml:id="functions.arguments.by-reference"> - <title>Verweise als Parameter übergeben</title> - + <title>Verweise als Parameter übergeben</title> + <simpara> Normalerweise werden den Funktionen Werte als Parameter - übermittelt. Wenn man den Wert dieses Parameters innerhalb der - Funktion ändert, bleibt der Parameter außerhalb der Funktion - unverändert. Wollen Sie aber genau das erreichen, dann müssen - Sie die Parameter als Verweise (Referenzen) übergeben. + übermittelt. Wenn man den Wert dieses Parameters innerhalb der + Funktion ändert, bleibt der Parameter auÃerhalb der Funktion + unverändert. Wollen Sie aber erreichen, dass die Ãnderung auch auÃerhalb + der Funktion sichtbar wird, müssen Sie die Parameter als Verweise + (Referenzen) übergeben. </simpara> - + <para> Wenn eine Funktion einen Parameter generell als Verweis behandeln - soll, setzt man in der Funktionsdefinition ein kaufmännisches Und + soll, setzt man in der Funktionsdefinition ein kaufmännisches Und (&) vor den Parameternamen: </para> <para> <example> - <title>Passing function parameters by reference</title> + <title>Ãbergeben von Funktionsparametern als Verweis</title> <programlisting role="php"> <![CDATA[ <?php @@ -250,14 +251,14 @@ </para> </sect2> - + <sect2 xml:id="functions.arguments.default"> - <title>Vorgabewerte für Parameter</title> - + <title>Vorgabewerte für Parameter</title> + <para> - Eine Funktion kann C++-artige Vorgabewerte für skalare Parameter + Eine Funktion kann C++-artige Vorgabewerte für skalare Parameter wie folgt definieren: - </para> + </para> <para> <example> @@ -277,10 +278,10 @@ </programlisting> </example> </para> - + <para> Die Ausgabe von diesem kleinen Skript ist: - + <screen> Ich mache eine Tasse Cappucino. Ich mache eine Tasse. @@ -288,7 +289,7 @@ </screen> </para> <para> - PHP gestattet es Arrays und den speziellen Typ &null; als + PHP gestattet es, Arrays und den speziellen Typ &null; als Vorgabewert zu nutzen, zum Beispiel: </para> <para> @@ -307,23 +308,23 @@ ?> ]]> </programlisting> - </example> + </example> </para> <simpara> - Der Vorgabewert muss ein konstanter Ausdruck sein, darf also (zum - Beispiel) keine Variable, Eigenschaft einer Klasse oder + Der Vorgabewert muss ein konstanter Ausdruck sein, darf also zum + Beispiel keine Variable, Eigenschaft einer Klasse oder ein Funktionsaufruf sein. </simpara> <para> - Bitte beachten Sie, dass alle Vorgabewerte rechts von den - Nicht-Vorgabeparametern stehen sollten; - sonst wird es nicht + Bitte beachten Sie, dass alle Vorgabewerte rechts von den + Nicht-Vorgabeparametern stehen sollten - sonst wird es nicht funktionieren. Betrachten Sie folgendes Beispiel: </para> <para> <example> - <title>Ungüötige Anwendung von Vorgabewerten</title> + <title>Ungültige Anwendung von Vorgabewerten</title> <programlisting role="php"> <![CDATA[ <?php @@ -331,31 +332,31 @@ { return "Mache einen Becher $typ $geschmack-joghurt.\n"; } - + echo mach_joghurt ("Brombeer"); // arbeitet nicht wie erwartet ?> ]]> </programlisting> </example> </para> - + <para> - Die Ausgabe dieses Beispiels ist:: + Die Ausgabe dieses Beispiels ist: </para> - + <para> <screen> -Warning: Missing argument 2 in call to makeyogurt() in +Warning: Missing argument 2 in call to mach_joghurt() in /usr/local/etc/httpd/htdocs/phptest/functest.html on line 41 Mache einen Becher Brombeer-joghurt. </screen> </para> - + <para> Nun vergleichen Sie bitte oberes Beispiel mit folgendem: </para> - <para> + <para> <example> <title>Richtiger Einsatz von Vorgabewerten</title> <programlisting role="php"> @@ -365,57 +366,58 @@ { return "Mache einen Becher $typ $geschmack-joghurt.\n"; } - + echo mach_joghurt ("Brombeer"); // arbeitet wie erwartet. ?> ]]> </programlisting> </example> </para> - + <para> ... und jetzt ist die Ausgabe: - + <screen> Mache einen Becher rechtsdrehendes Brombeer-Joghurt. </screen> </para> <para> - Default value for arguments passed by reference is supported since PHP 5. - </para> + Das Setzen von Standardwerten für Argumente, die als Verweis übergeben + werden ("passed by reference") wird seit PHP 5 unterstützt. + </para> </sect2> <sect2 xml:id="functions.variable-arg-list"> <title>Variable Anzahl von Parametern</title> - + <simpara> Beginnend mit PHP 4 wird eine variable Anzahl von Parametern in - benutzerdefinierten Funktionen unterstützt. Das Handling dieser Parameter - fällt mittels der Funktionen <function>func_num_args</function>, + benutzerdefinierten Funktionen unterstützt. Das Handling dieser Parameter + fällt mittels der Funktionen <function>func_num_args</function>, <function>func_get_arg</function> und <function>func_get_args</function> sehr leicht. </simpara> <simpara> - Es ist keine spezielle Syntax erforderlich. Die Parameter können + Es ist keine spezielle Syntax erforderlich. Die Parameter können wie gehabt explizit in den Funktionsdeklarationen angegeben - werden, und werden sich wie gewohnt verhalten. + werden und werden sich wie gewohnt verhalten. </simpara> </sect2> </sect1> - + <sect1 xml:id="functions.returning-values"> - <title>Rückgabewerte</title> - + <title>Rückgabewerte</title> + <para> - Sie können Werte mit dem optionalen Befehl "return" zurückgeben. - Es können Variablen jedes Typs zurückgegeben werden, auch Listen - oder Objekte. Die beendet sofort die Funktion, und die Kontrolle - wird wieder an die aufrufende Zeile zurückgegeben. Weitere + Sie können Werte mit dem optionalen Befehl "return" zurückgeben. + Es können Variablen jeden Typs zurückgegeben werden, auch Arrays + oder Objekte. Dies beendet sofort die Funktion und die Kontrolle + wird wieder an die aufrufende Zeile zurückgegeben. Weitere Informationen finden Sie unter <function>return</function>. </para> @@ -436,16 +438,16 @@ </programlisting> </example> </para> - + <para> - Es ist nicht möglich, mehrere Werte von einer Funktion zurückzugeben. - Ein ähnliches Resultat kann man aber durch die Rückgabe von Listen + Es ist nicht möglich, mehrere Werte von einer Funktion zurückzugeben. + Ein ähnliches Resultat kann man aber durch die Rückgabe von Arrays erreichen. </para> - - <para> + + <para> <example> - <title>Rückgabe mehrere Werte in Arrays</title> + <title>Rückgabe mehrere Werte in Arrays</title> <programlisting role="php"> <![CDATA[ <?php @@ -460,14 +462,14 @@ </example> </para> <para> - Um von einer Funktion eine Referenz zurückzugeben, müssen Sie + Um von einer Funktion eine Referenz zurückzugeben, müssen Sie den Referenz-Operator & sowohl in der Funktionsdeklaration, - als auch bei der Zuweisung des zurückgegebenen Wertes verwenden: + als auch bei der Zuweisung des zurückgegebenen Wertes verwenden: </para> <para> <example> - <title>Rückgabe von Referenzen</title> + <title>Rückgabe von Referenzen</title> <programlisting role="php"> <![CDATA[ <?php @@ -483,19 +485,19 @@ </example> </para> <simpara> - Weitere Informationen über Referenzen finden Sie im Kapitel + Weitere Informationen über Referenzen finden Sie im Kapitel <link linkend="language.references">Referenzen in PHP</link>. </simpara> </sect1> - + <sect1 xml:id="functions.variable-functions"> <title>Variablenfunktionen</title> <para> - PHP unterstützt das Konzept der Variablenfunktionen. Wenn Sie an - das Ende einer Variablen Klammern hängen, versucht PHP eine - Funktion aufzurufen, deren Name der aktuelle Wert der Variable - ist. Dies kann unter anderem für Callbacks, Funktionstabellen, + PHP unterstützt das Konzept der Variablenfunktionen. Wenn Sie an + das Ende einer Variablen Klammern hängen, versucht PHP eine + Funktion aufzurufen, deren Name der aktuelle Wert der Variablen + ist. Dies kann unter anderem für Callbacks, Funktionstabellen, usw. genutzt werden. </para> <para> @@ -503,13 +505,13 @@ wie <function>echo</function>, <function>print</function>, <function>unset</function>, <function>isset</function>, <function>empty</function>, <function>include</function> und - <function>require</function>. Sie müssen Ihre eigenen Wrapperfunktionen + <function>require</function>. Sie müssen Ihre eigenen Wrapperfunktionen verwenden, um diese Konstrukte als variable Funktionen benutzen zu - können. + können. </para> <para> <example> - <title>Beispiel für Variablenfunktionen</title> + <title>Beispiel für Variablenfunktionen</title> <programlisting role="php"> <![CDATA[ <?php @@ -523,7 +525,7 @@ echo "In bar(); der Parameter ist '$arg'.<br />\n"; } -// Dies ist eine Wrapperfunkiton für echo +// Dies ist eine Wrapperfunkiton für echo function echoit($string) { echo $string; @@ -543,7 +545,7 @@ </example> </para> <para> - Sie können auch die Methode eines Objektes mittels der variablen + Sie können auch die Methode eines Objektes mittels der variablen Funktionen aufrufen. <example> <title>Variable Methode</title> @@ -557,7 +559,7 @@ $name = 'Bar'; $this->$name(); // Dies ruft die Bar() Methode auf } - + function Bar() { echo "Das ist Bar"; @@ -574,64 +576,61 @@ </example> </para> <para> - Siehe auch <function>call_user_func</function>, - <link linkend="language.variables.variable"> - Variable Variablen</link> und <function>function_exists</function>. + Siehe auch + <function>call_user_func</function>, + <link linkend="language.variables.variable">Variable Variablen</link> und + <function>function_exists</function>. </para> </sect1> - <sect1 xml:id="functions.internal"> <title>Interne (eingebaute) Funktionen</title> <para> - PHP enthält standmäßig viele Funktionen und Konstrukte, weiterhin - gibt es viele Funktionen die vorausssetzen dass bestimmte PHP - Extensions einkompiliert wurden, anderenfalls erhalten Sie beim - Aufruf "undefined function" Fehlermeldungen. + PHP enthält standmäÃig viele Funktionen und Konstrukte, weiterhin + gibt es viele Funktionen die vorausssetzen, dass bestimmte PHP-Extensions + einkompiliert wurden, anderenfalls erhalten Sie beim + Aufruf "undefined function"-Fehlermeldungen. Um z.B. <link linkend="ref.image">Grafik-Funktionen</link> wie - <function>imagecreatetruecolor</function> müssen Sie PHP mit - <productname>GD</productname> Unterstützung kompilieren, oder um - <function>mysql_connect</function> - zu Nutzen muss Ihr PHP mit <link linkend="ref.mysql">MySQL</link> - UNterstützung compiliert sein. - Viele Kernfunktionen wie z.B. die <link linkend="ref.strings" - >String</link>- und <link linkend="language.variables">Variablen</link - >-Funktionen sind bereits in jeder PHP Version enthalten. - Ein Aufruf von <function>phpinfo</function> oder <function - >get_loaded_extensions</function> zeigt Ihnen welche Extensions - in Ihrer PHP Installation verfügbar sind. - Beachten Sie weiterhin das viele Extensions bereits standardmäßig - aktiviert sind und das PHP Manual nach Extensions unterteilt ist. + <function>imagecreatetruecolor</function> zu nutzen, müssen Sie PHP mit + <productname>GD</productname>-Unterstützung kompilieren, oder um + <function>mysql_connect</function> zu nutzen, muss Ihr PHP mit <link + linkend="ref.mysql">MySQL</link>-Unterstützung kompiliert sein. + Viele Kernfunktionen wie z.B. die <link + linkend="ref.strings">String</link>- und <link + linkend="language.variables">Variablen</link>-Funktionen sind bereits in + jeder PHP-Version enthalten. Ein Aufruf von <function>phpinfo</function> + oder <function>get_loaded_extensions</function> zeigt Ihnen, welche + Extensions in Ihrer PHP-Installation verfügbar sind. + Beachten Sie weiterhin, dass viele Extensions bereits standardmäÃig + aktiviert sind und das PHP-Manual nach Extensions unterteilt ist. Weitere Informationen zur Einrichtung von PHP finden Sie in den - Kapiteln <link linkend="configuration">konfiguration</link>, + Kapiteln <link linkend="configuration">Konfiguration</link>, <link linkend="install">Installation</link> und den Kapiteln zu den einzelnen Extensions. </para> <para> - Wie Funktionsprototypen zu lesen und zu verstehen sind ist im - Kapitel '<link linkend="about.prototypes">Wie man eine Funktionsdefinition - (Prototyp) liest'</link> erklärt. - Es ist wichtig zu erkennen was eine Funktion zurückgibt und ob - die übergebenen Parameter verändert werden. So gibt z.B. - <function>str_replace</function> den bearbeiteten String zurück - während <function>usort</function> direkt auf der übergebenen + Wie Funktionsprototypen zu lesen und zu verstehen sind, ist im + Kapitel '<link linkend="about.prototypes">Wie man eine Funktionsdefinition + (Prototyp) liest'</link> erklärt. + Es ist wichtig zu erkennen, was eine Funktion zurückgibt und ob + die übergebenen Parameter verändert werden. So gibt z.B. + <function>str_replace</function> den bearbeiteten String zurück, + während <function>usort</function> direkt auf der übergebenen Variablen arbeitet. - itself. - Jede Handbuchseite enthält spezifische Informatione für jede - Funktion wie ihre Parameter, Rückgabewerte sowohl bei Erfolg - als auch im Fehlerfall, Änderungen des Verhaltens und Verfügbarkeit. - Kenntniss dieser wichtigen (und oft subtilen) Unterschiede ist - von entscheidender Bedeutung für das Schreiben korekten PHP Kodes. + Jede Handbuchseite enthält spezifische Informationen für jede + Funktion wie ihre Parameter, die Rückgabewerte sowohl bei Erfolg + als auch im Fehlerfall, Ãnderungen des Verhaltens und die Verfügbarkeit. + Die Kenntnis dieser wichtigen (und oft subtilen) Unterschiede ist + von entscheidender Bedeutung für das Schreiben korrekten PHP-Codes. </para> <note> <simpara> Wenn Funktionen andere Parameter erhalten als erwartet, d.h. wenn z.B. - ein <type>array</type> übergeben wird obwohl ein <type>string</type> - erwartet wird, so ist der Rückgabewert undefiniert. In solchen Fällen - ist es üblich das &null; zurückgegeben wird, dies ist aber nur eine - Konvention auf die Sie sich nicht unbedingt verlassen können. - upon. + ein <type>array</type> übergeben wird obwohl ein <type>string</type> + erwartet wird, so ist der Rückgabewert undefiniert. In solchen Fällen + ist es üblich, dass &null; zurückgegeben wird, dies ist aber nur eine + Konvention, auf die Sie sich nicht unbedingt verlassen können. </simpara> </note> <para> @@ -642,7 +641,7 @@ </para> </sect1> </chapter> - + <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/viewvc.cgi/phpdoc-de/language-snippets.ent?r1=1.36&r2=1.37&diff_format=u Index: phpdoc-de/language-snippets.ent diff -u phpdoc-de/language-snippets.ent:1.36 phpdoc-de/language-snippets.ent:1.37 --- phpdoc-de/language-snippets.ent:1.36 Mon Jun 16 22:50:17 2008 +++ phpdoc-de/language-snippets.ent Tue Jun 17 12:08:18 2008 @@ -1,5 +1,5 @@ -<?xml version='1.0' encoding='ISO-8859-1' ?> -<!-- $Revision: 1.36 $ --> +<?xml version='1.0' encoding='utf-8' ?> +<!-- $Revision: 1.37 $ --> <!-- EN-Revision: 1.219 Maintainer: hholzgra Status: ready --> <!-- CREDITS: mk, betz --> @@ -14,65 +14,65 @@ werden gecached. Weitere Details erhalten Sie bei <function>clearstatcache</function>.</simpara></note>'> -<!ENTITY note.context-support '<note><simpara>Die Kontext-Unterstützung gibt +<!ENTITY note.context-support '<note><simpara>Die Kontext-Unterstützung gibt es seit PHP 5.0.0. Eine Beschreibung von <literal>Kontexten</literal> finden Sie unter <xref linkend="ref.stream"/>.</simpara></note>'> <!ENTITY note.exec-bg '<note><para>Falls Sie diese Funktion benutzen, um ein -Programm zu starten und im Hintergrund weiterlaufen lassen möchten, -müssen Sie sicherstellen, dass die Ausgabe des Programms in eine Datei oder +Programm zu starten und im Hintergrund weiterlaufen lassen möchten, +müssen Sie sicherstellen, dass die Ausgabe des Programms in eine Datei oder einen anderen Ausgabestream umgeleitet wird. Anderenfalls wird PHP solange -hängen, bis das Programm zu Ende ausgeführt wurde.</para></note>'> +hängen, bis das Programm zu Ende ausgeführt wurde.</para></note>'> <!ENTITY note.func-callback '<note><simpara>Anstelle eines Funktionsnamens kann auch ein Array mit einer Objekt-Referenz und dem Namen einer Methode angegeben werden.</simpara></note>'> <!ENTITY note.funcnoparam '<note><para>Da diese Funktion bei der Ermittlung -der Parameterdetails von dem aktuellen Ausführungskontext abhängt kann sie +der Parameterdetails von dem aktuellen Ausführungskontext abhängt kann sie selbst nicht als Funktionsparameter genutzt werden. Wenn Sie ihre Ergebnisse -tatsächlich weitergeben müssen so müssen Sie diese zunächst an eine Variable -zuweisen und dann diese Variable übergeben</para></note>'> +tatsächlich weitergeben müssen so müssen Sie diese zunächst an eine Variable +zuweisen und dann diese Variable übergeben</para></note>'> <!ENTITY note.line-endings '<note><simpara>Wenn Sie Probleme damit haben, dass PHP Zeilenendezeichen nicht erkennt, entweder beim Lesen von Dateien auf einem -Macintosh oder bei Dateien die auf einem Macintosh erstellt wurden, können Sie +Macintosh oder bei Dateien die auf einem Macintosh erstellt wurden, können Sie die Option <link linkend="ini.auto-detect-line-endings"> auto_detect_line_endings</link> aktivieren.</simpara></note>'> <!ENTITY note.no-remote '<note><simpara>Diese Funktion kann nicht mit <link linkend="features.remote-files">entfernten Dateien</link> arbeiten, da -der Zugriff auf die Datei, die bearbeitet werden soll, über das Dateisystem des -Servers möglich sein muss.</simpara></note>'> +der Zugriff auf die Datei, die bearbeitet werden soll, über das Dateisystem des +Servers möglich sein muss.</simpara></note>'> <!ENTITY note.no-key-association '<note><simpara>Diese Funktion weist den -Elementen des Arrays <parameter>array</parameter> neue Schlüssel zu. -Bestehende Schlüssel die Sie eventuell zugewiesen haben werden entfernt -statt einfach nur die Schlüssel neu anzuordnen</simpara></note>'> +Elementen des Arrays <parameter>array</parameter> neue Schlüssel zu. +Bestehende Schlüssel die Sie eventuell zugewiesen haben werden entfernt +statt einfach nur die Schlüssel neu anzuordnen</simpara></note>'> <!ENTITY note.no-windows '<note><simpara>Diese Funktion ist auf Windows-Plattformen nicht implementiert.</simpara></note>'> <!ENTITY note.no-windows.extension '<note><simpara>Diese Erweiterung steht auf -Windowsbetriebssystemen nicht zur Verfügung.</simpara></note>'> +Windowsbetriebssystemen nicht zur Verfügung.</simpara></note>'> <!ENTITY note.randomseed '<note><simpara>Seit PHP 4.2.0 besteht keine -Notwendigkeit mehr, den Zufallsgenerator für Zahlen mit -<function>srand</function> oder <function>mt_srand</function> zu füttern, das +Notwendigkeit mehr, den Zufallsgenerator für Zahlen mit +<function>srand</function> oder <function>mt_srand</function> zu füttern, das geschieht nun automatisch.</simpara></note>'> <!ENTITY note.registerglobals '<note><title>register_globals: Wichtiger -Hinweis</title><para>Seit PHP 4.2.0 ist die Standardeinsteillung für die +Hinweis</title><para>Seit PHP 4.2.0 ist die Standardeinsteillung für die Konfigurationsoption <link linkend="ini.register-globals"> -register_globals</link> <emphasis>off</emphasis> und in PHP 6 wird -diese Option endgültig entfernt. Die PHP Community ermutigt +register_globals</link> <emphasis>off</emphasis> und in PHP 6 wird +diese Option endgültig entfernt. Die PHP Community ermutigt alle, sich nicht auf diese Option zu verlassen und Alternativen wie &link.superglobals; zu verwenden.</para></note>'> <!ENTITY note.superglobals '<note><title>Superglobals: Hinweis zur -Verfügbarkeit</title><para>Seit PHP 4.1.0 stehen superglobale Arrays wie +Verfügbarkeit</title><para>Seit PHP 4.1.0 stehen superglobale Arrays wie <varname>$_GET</varname>, <varname>$_POST</varname>,<varname>$_SERVER</varname>, -etc. zur Verfügung. Weitere Informationen können Sie dem Abschnitt zu +etc. zur Verfügung. Weitere Informationen können Sie dem Abschnitt zu &link.superglobals; entnehmen.</para></note>'> <!ENTITY note.uses-ob '<note><para>Diese Funktion benutzt intern @@ -82,25 +82,25 @@ <!-- Tips --> -<!ENTITY tip.fopen-wrapper '<tip><simpara>Mit dieser Funktion können Sie eine +<!ENTITY tip.fopen-wrapper '<tip><simpara>Mit dieser Funktion können Sie eine URL als Dateinamen verwenden, falls Sie <link linkend="ini.allow-url-fopen"> -fopen wrappers</link> ermöglicht haben. Mehr Details dazu, wie Sie den -Dateinamen angeben müssen finden Sie bei <function>fopen</function>. Eine -Liste der unterstützten URL Protokolle finden Sie unter +fopen wrappers</link> ermöglicht haben. Mehr Details dazu, wie Sie den +Dateinamen angeben müssen finden Sie bei <function>fopen</function>. Eine +Liste der unterstützten URL Protokolle finden Sie unter <xref linkend="wrappers"/>.</simpara></tip>'> <!ENTITY tip.fopen-wrapper.stat '<tip><simpara>Seit PHP 5.0.0 kann diese Funktion mit <emphasis>einigen</emphasis> URL-Wrappern benutzt werden. Schauen Sie in der Liste unter <xref linkend="wrappers"/> nach, welcher Wrapper die -Funktionalität von <function>stat</function> unterstützt.</simpara></tip>'> +Funktionalität von <function>stat</function> unterstützt.</simpara></tip>'> <!ENTITY tip.ob-capture '<tip><simpara>Bei allem, dessen Ergebnisausgabe direkt -im Browser angezeigt wird, können Sie die +im Browser angezeigt wird, können Sie die <link linkend="ref.outcontrol">Funktionen zur Ausgabesteuerung</link> verwenden. -Damit lässt sich die Ausgabe dieser Funktion erfassen, und - zum Beispiel - +Damit lässt sich die Ausgabe dieser Funktion erfassen, und - zum Beispiel - in einem <type>string</type> speichern.</simpara></tip>'> -<!ENTITY tip.userlandnaming '<tip><simpara>Siehe auch<xref linkend="userlandnaming" +<!ENTITY tip.userlandnaming '<tip><simpara>Siehe auch<xref linkend="userlandnaming" />.</simpara></tip>'> <!-- Warnings --> @@ -109,19 +109,19 @@ Usereingaben an diese Funktion weitergereicht werden, sollten Sie <function>escapeshellarg</function> oder <function>escapeshellcmd</function> verwenden. Bei Verwendung dieser Funktionen stellen Sie sicher, dass kein -Benutzer Ihr System überlisten kann beliebige Kommandos auszuführen</para></warning>'> +Benutzer Ihr System überlisten kann beliebige Kommandos auszuführen</para></warning>'> <!ENTITY warn.experimental '<warning xmlns="http://docbook.org/ns/docbook"> <simpara>Diese Erweiterung ist <emphasis>EXPERIMENTELL</emphasis>. Das Verhalten dieser Erweiterung, -einschließlich der Funktionsnamen, und alles Andere was hier dokumentiert -ist, kann sich in zukünftigen PHP-Versionen ohne Ankündigung ändern. Seien +einschlieÃlich der Funktionsnamen, und alles Andere was hier dokumentiert +ist, kann sich in zukünftigen PHP-Versionen ohne Ankündigung ändern. Seien Sie gewarnt und verwenden Sie diese Erweiterung auf eigenes Risiko. </simpara></warning>'> <!ENTITY warn.deprecated.removed-6-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara> Dieses Feature ist <emphasis>DEPRECATED</emphasis> (veraltet) und wird in PHP 6.0.0 -<emphasis>ENTFERNT</emphasis>. Sich auf dieses Feature zu verlassen ist +<emphasis>ENTFERNT</emphasis>. Sich auf dieses Feature zu verlassen ist in keiner Weise empfehlenswert.</simpara></warning>'> <!ENTITY warn.deprecated.function.removed-5-3-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara> @@ -131,49 +131,49 @@ <!ENTITY warn.experimental.func '<warning xmlns="http://docbook.org/ns/docbook"> <simpara>Diese Funktion ist <emphasis>EXPERIMENTELL</emphasis>. Das Verhalten, der Funktionsname und alles -Andere was hier dokumentiert ist, kann sich in zukünftigen PHP-Versionen ohne -Ankündigung ändern. Seien Sie gewarnt und verwenden Sie diese Funktion auf +Andere was hier dokumentiert ist, kann sich in zukünftigen PHP-Versionen ohne +Ankündigung ändern. Seien Sie gewarnt und verwenden Sie diese Funktion auf eigenes Risiko.</simpara></warning>'> <!ENTITY warn.imaprecodeyaz '<warning><simpara>Die <link -linkend="ref.imap">IMAP</link> , <link linkend="ref.recode">recode</link>, +linkend="ref.imap">IMAP</link> , <link linkend="ref.recode">recode</link>, <link linkend="ref.yaz">YAZ</link> und <link linkend="ref.cyrus">Cyrus</link> -können nicht zusammen verwendet werden. Diese Tatsache -liegt darin begründet, dass alle diese Erweiterungen die gleichen internen Symbole +können nicht zusammen verwendet werden. Diese Tatsache +liegt darin begründet, dass alle diese Erweiterungen die gleichen internen Symbole benutzen.</simpara></warning>'> <!ENTITY warn.install.cgi '<warning><para>Wenn Sie das CGI Setup verwenden, -ist Ihr Server für einige mögliche Angriffe anfällig. Wie Sie sich vor diesen -Angriffen schützen können, entnehmen Sie bitte dem -<link linkend="security.cgi-bin">Kapitel über CGI Sicherheit</link>.</para></warning>'> +ist Ihr Server für einige mögliche Angriffe anfällig. Wie Sie sich vor diesen +Angriffen schützen können, entnehmen Sie bitte dem +<link linkend="security.cgi-bin">Kapitel über CGI Sicherheit</link>.</para></warning>'> <!ENTITY note.magicquotes.gpc '<note><title>Hinweis zu magic_quotes_gpc </title><para>Die PHP Konfigurationsoption <link linkend="ini.magic-quotes-gpc"> magic_quotes_gpc</link> ist im Standard auf <literal>on</literal> gesetzt. Das -bedeutet, dass <function>addslashes</function> für alle GET, POST und COOKIE -Daten automatisch ausgeführt wird. Sie können <function>stripslashes</function> +bedeutet, dass <function>addslashes</function> für alle GET, POST und COOKIE +Daten automatisch ausgeführt wird. Sie können <function>stripslashes</function> verwenden um diese Slashes zu entfernen.</para></note>'> <!ENTITY warn.no-win32-fopen-wrapper '<warning><para>PHP Versionen kleiner 4.3.0 -für Windows, erlauben den Zugriff auf Remote-Dateien mit dieser Funktion nicht, +für Windows, erlauben den Zugriff auf Remote-Dateien mit dieser Funktion nicht, selbst wenn <link linkend="ini.allow-url-fopen">allow_url_fopen</link> aktiviert ist.</para></warning>'> <!ENTITY warn.ssl-non-standard '<warning><para>Bei SSL-Verbindungen zusammen -mit Microsoft IIS hält sich dieser Webserver nicht an das Protokoll und -schließt die Verbindung ohne ein <literal>close_notify</literal> zu senden. -PHP quittiert dieses Fehlverhalten mit "SSL: Fatal Protocol Error", wenn das -Ende der Daten erreicht ist. Eine mögliche Lösung besteht darin, das Level von +mit Microsoft IIS hält sich dieser Webserver nicht an das Protokoll und +schlieÃt die Verbindung ohne ein <literal>close_notify</literal> zu senden. +PHP quittiert dieses Fehlverhalten mit "SSL: Fatal Protocol Error", wenn das +Ende der Daten erreicht ist. Eine mögliche Lösung besteht darin, das Level von <link linkend="ini.error-reporting">error_reporting</link> herabzusetzten und -warnings auzuschließen. Ab PHP 4.3.7 kann PHP fehlerhafte IIS Serversoftware -erkennen, wenn Sie einen Stream mit dem <literal>https://</literal> Wrapper öffnen -und unterdrückt die Warnung für Sie. Falls Sie <function>fsockopen</function> -benutzen um einen <literal>ssl://</literal> Socket zu öffnen, müssen Sie selbst -dafür Sorge tragen, die Warnung zu erkennen und diese zu unterdrücken.</para> +warnings auzuschlieÃen. Ab PHP 4.3.7 kann PHP fehlerhafte IIS Serversoftware +erkennen, wenn Sie einen Stream mit dem <literal>https://</literal> Wrapper öffnen +und unterdrückt die Warnung für Sie. Falls Sie <function>fsockopen</function> +benutzen um einen <literal>ssl://</literal> Socket zu öffnen, müssen Sie selbst +dafür Sorge tragen, die Warnung zu erkennen und diese zu unterdrücken.</para> </warning>'> <!ENTITY warn.undocumented.func '<warning><simpara>Diese Funktion ist bis jetzt -nicht dokumentiert. Es steht nur die Liste der Argumente zur Verfügung. +nicht dokumentiert. Es steht nur die Liste der Argumente zur Verfügung. </simpara></warning>'> @@ -185,141 +185,141 @@ Ausgabe:</para>'> <!ENTITY example.outputs.similar '<para>Das oben gezeigte Beispiel erzeugt -eine ähnliche Ausgabe wie: </para>'> +eine ähnliche Ausgabe wie: </para>'> <!ENTITY array.resetspointer '<note><simpara>Diese Funktion setzt (<function>reset</function>) nach Verwendung den <type>array</type>-Zeiger -zurück.</simpara></note>'> +zurück.</simpara></note>'> -<!ENTITY seealso.callback 'Informationen über den <link +<!ENTITY seealso.callback 'Informationen über den <link linkend="language.types.callback">Callback</link>-Typ'> -<!ENTITY avail.register-long-arrays 'Seit PHP 5.0.0 können Sie die +<!ENTITY avail.register-long-arrays 'Seit PHP 5.0.0 können Sie die Registrierung der langen von PHP <link linkend="language.variables.predefined"> vordefinierten Arrays</link> mit der Konfigurationsoption <link linkend="ini.register-long-arrays">register_long_arrays</link> abschalten.'> <!ENTITY ini.shorthandbytes '<simpara>Wird ein <type>integer</type> Wert -verwendet, wird dieser Wert in Bytes gemessen. Sie können auch die +verwendet, wird dieser Wert in Bytes gemessen. Sie können auch die Kurzschreibweise verwenden, wie in <link linkend="faq.using.shorthandbytes"> dieser FAQ</link> beschrieben.</simpara>'> -<!ENTITY info.deprecated.alias 'Für die Abwärtskompatibiliät kann der +<!ENTITY info.deprecated.alias 'Für die Abwärtskompatibiliät kann der folgende veraltete Alias verwendet werden: '> -<!ENTITY info.function.alias 'Diese Funktion ist ein Alias für: '> +<!ENTITY info.function.alias 'Diese Funktion ist ein Alias für: '> <!ENTITY info.function.alias.deprecated '<simpara>Dieser Funktion-Alias -ist veraltet und existiert nur noch aus Gründen der Rückwärtskompatibilität. +ist veraltet und existiert nur noch aus Gründen der Rückwärtskompatibilität. Es wird nicht empfohlen diese Funktion weiter zu nutzen da sie eines Tages aus PHP entfernt werden kann.</simpara>'> <!ENTITY ext.windows.path.dll 'Diese Extension benotigt <acronym>DLL</acronym> -Dateien die für Windows verfügbar seien müssen. Der <acronym>FAQ</acronym> Eintrag -"<link linkend="faq.installation.addtopath"> Wie füge ich unter Windows PATH mein -PHP-Verzeichnis hinzu?</link>" gibt hierzu weitere Informationen. Obwohl ein +Dateien die für Windows verfügbar seien müssen. Der <acronym>FAQ</acronym> Eintrag +"<link linkend="faq.installation.addtopath"> Wie füge ich unter Windows PATH mein +PHP-Verzeichnis hinzu?</link>" gibt hierzu weitere Informationen. Obwohl ein einfaches Kopieren der DLL Dateien vom PHP Verzeichnis in den Windows -Systemordner auch funktioniert (weil der Systemordner immer im +Systemordner auch funktioniert (weil der Systemordner immer im <literal>PATH</literal> enthalten ist) ist dieses Vorgehen nicht empfehlenswert. -<emphasis>Diese Extension benötigt die folgenden Dateien im <literal>PATH</literal>: +<emphasis>Diese Extension benötigt die folgenden Dateien im <literal>PATH</literal>: </emphasis>'> <!-- Returns --> -<!ENTITY return.success 'Gibt bei Erfolg &true; zurück, im Fehlerfall &false;.'> +<!ENTITY return.success 'Gibt bei Erfolg &true; zurück, im Fehlerfall &false;.'> -<!ENTITY return.void 'Es wird kein Wert zurückgegeben.'> +<!ENTITY return.void 'Es wird kein Wert zurückgegeben.'> <!ENTITY return.falseproblem '<warning><simpara>Diese Funktion kann sowohl das -Boolsche &false; zurückliefern, als auch einen nicht-Boolschen Wert, wie zum +Boolsche &false; zurückliefern, als auch einen nicht-Boolschen Wert, wie zum Beispiel<literal>0</literal> oder "". der von einem einfachen if-Statement als &false; ausgewertet wird. Weitere Informationen entnehmen Sie -bitte dem Abschnitt über die <link linkend="language.types.boolean"> +bitte dem Abschnitt über die <link linkend="language.types.boolean"> Boolsche Typen</link>. Benutzen Sie deshalb <link linkend="language.operators.comparison">den === Operator</link> -um den Rückgabewert dieser Funktion zu überprüfen.</simpara></warning>'> +um den Rückgabewert dieser Funktion zu überprüfen.</simpara></warning>'> <!-- Image (GD) Notes --> <!ENTITY note.config.t1lib '<note><simpara>Diese Funktion steht nur zur -Verfügung, wenn PHP mit der Option <option -role="configure">--with-t1lib[=DIR]</option> übersetzt +Verfügung, wenn PHP mit der Option <option +role="configure">--with-t1lib[=DIR]</option> übersetzt wurde.</simpara></note>'> -<!ENTITY note.config.jpeg '<note><simpara>Die Unterstützung von JPEG steht nur -zur Verfügung, wenn PHP mit GD-1.8 oder höher übersetzt +<!ENTITY note.config.jpeg '<note><simpara>Die Unterstützung von JPEG steht nur +zur Verfügung, wenn PHP mit GD-1.8 oder höher übersetzt wurde.</simpara></note>'> -<!ENTITY note.config.wbmp '<note><simpara>Die Unterstützung von WBMP steht nur -zur Verfügung, wenn PHP mit GD-1.8 oder höher übersetzt +<!ENTITY note.config.wbmp '<note><simpara>Die Unterstützung von WBMP steht nur +zur Verfügung, wenn PHP mit GD-1.8 oder höher übersetzt wurde.</simpara></note>'> -<!ENTITY note.bundled.gd '<note><simpara>Diese Funktion steht nur zur Verfügung, -wenn PHP mit der GD Bibliothek übersetzt wurde, die mit PHP zusammen erhältlich +<!ENTITY note.bundled.gd '<note><simpara>Diese Funktion steht nur zur Verfügung, +wenn PHP mit der GD Bibliothek übersetzt wurde, die mit PHP zusammen erhältlich ist.</simpara></note>'> -<!ENTITY note.freetype '<note><simpara>Diese Funktion ist nur verfügbar -wenn PHP mit Freetype unterstützung (<option role="configure">--with-freetype-dir=DIR</option>) +<!ENTITY note.freetype '<note><simpara>Diese Funktion ist nur verfügbar +wenn PHP mit Freetype unterstützung (<option role="configure">--with-freetype-dir=DIR</option>) kompiliert wurde</simpara></note>'> <!ENTITY note.gd.2 '<note><simpara>Diese Funktion setzt die GD Bibliothek in -der Version 2.0.1 oder höher (empfohlen wird mindestens 2.0.28) voraus.</simpara></note>'> +der Version 2.0.1 oder höher (empfohlen wird mindestens 2.0.28) voraus.</simpara></note>'> <!ENTITY gd.image.description '<varlistentry><term><parameter>image</parameter> </term><listitem><para>Eine von den verschiedenen Erzeugungsfunktionen wie <function>imagecreatetruecolor</function> gelieferte Grafikresource.</para> </listitem></varlistentry>'> - + <!ENTITY gd.font.description '<varlistentry><term><parameter> -font</parameter></term><listitem><para>Ein Wert zwischen 1 und 5 für -eingebaute Schriftarten in Latin2 kodierung (wobei größere Werte größeren -Schriften entsprechen) oder einer Ihrer mit <function>imageloadfont</function> -selbst registrierten Schrifteinträge.</para></listitem></varlistentry>'> +font</parameter></term><listitem><para>Ein Wert zwischen 1 und 5 für +eingebaute Schriftarten in Latin2 kodierung (wobei gröÃere Werte gröÃeren +Schriften entsprechen) oder einer Ihrer mit <function>imageloadfont</function> +selbst registrierten Schrifteinträge.</para></listitem></varlistentry>'> <!-- DBM notes --> - + <!ENTITY dbm.dbm-identifier.description '<varlistentry><term><parameter> dbm_identifier</parameter></term><listitem><para>Ein von <function>dbmopen</function> -zurückgegebenes DBM Verbindungshandle.</para></listitem></varlistentry>'> +zurückgegebenes DBM Verbindungshandle.</para></listitem></varlistentry>'> <!-- cURL notes --> - + <!ENTITY curl.ch.description '<varlistentry><term><parameter>ch</parameter> -</term><listitem><para>Ein von <function>curl_init</function> zurückgegebenes +</term><listitem><para>Ein von <function>curl_init</function> zurückgegebenes cURL-Handle.</para></listitem></varlistentry>'> - + <!ENTITY curl.mh.description '<varlistentry><term><parameter>mh</parameter> -</term><listitem><para>Ein von <function>curl_multi_init</function> zurückgegebenes +</term><listitem><para>Ein von <function>curl_multi_init</function> zurückgegebenes cURL-Multihandle.</para></listitem></varlistentry>'> <!-- IMAP notes --> - + <!ENTITY imap.imap-stream.description '<varlistentry><term><parameter> imap_stream</parameter></term><listitem><para>Eine von <function>imap_open</function> -zurückgegebene IMAP-Verbindung.</para></listitem></varlistentry>'> +zurückgegebene IMAP-Verbindung.</para></listitem></varlistentry>'> <!-- mbstring notes --> -<!ENTITY note.mbstring.encoding.internal '<note><para>Das interne +<!ENTITY note.mbstring.encoding.internal '<note><para>Das interne Encoding oder das mit <function>mb_regex_encoding</function> festgelegte -Zeichenencoding wird als Zeichenencoding für diese Funktion genutzt.</para></note>'> - +Zeichenencoding wird als Zeichenencoding für diese Funktion genutzt.</para></note>'> + <!ENTITY mbstring.encoding.parameter '<para>Der <parameter>encoding</parameter> -Parameter legt das Zeichenencoding fest. Wird er nicht übergeben so wird +Parameter legt das Zeichenencoding fest. Wird er nicht übergeben so wird das interne Zeichenencoding genutzt.</para>'> <!-- MCVE notes --> - + <!ENTITY mcve.conn.description '<varlistentry><term><parameter> conn</parameter></term><listitem><para>Eine von <function>m_initengine</function> -zurückgegebene MCVE_CONN Resource.</para></listitem></varlistentry>'> +zurückgegebene MCVE_CONN Resource.</para></listitem></varlistentry>'> <!-- Date and time entities --> -<!ENTITY note.timezone.errors.description '<para>Jeder Aufruf der Datums- und Zeitfunktionen +<!ENTITY note.timezone.errors.description '<para>Jeder Aufruf der Datums- und Zeitfunktionen Funktionen eine <constant>E_NOTICE</constant> Warnung -wenn die Zeitzone ungültig ist und eine <constant>E_STRICT</constant> +wenn die Zeitzone ungültig ist und eine <constant>E_STRICT</constant> Nachricht wenn die Systemeinstellung oder die <varname>TZ</varname> -Umgebungsvariable genutzt wird. Sie auch +Umgebungsvariable genutzt wird. Sie auch <function>date_default_timezone_set</function> </para>'> @@ -331,45 +331,45 @@ <varlistentry><term><parameter>timestamp</parameter></term><listitem><para> Der optionale Parameter <parameter>timestamp</parameter> ist ein Unix Timestamp als <type>integer</type> oder die aktuelle lokale Zeit -wenn kein <parameter>timestamp</parameter> übergeben wurde. Er entspricht +wenn kein <parameter>timestamp</parameter> übergeben wurde. Er entspricht dann also dem Ergebnis der Funktion <function>time</function>. </para></listitem></varlistentry>'> <!-- DomXml Notes --> <!ENTITY node.inserted 'Dieser Knoten wird in Ihrem Dokument nicht sichtbar sein, bis dieser zum Beispiel mit der Funktion <function>domnode_append_child -</function> eingefügt wird.'> +</function> eingefügt wird.'> <!-- Dom Notes --> <!ENTITY dom.node.inserted 'Dieser Knoten wird in Ihrem Dokument nicht sichtbar sein, bis dieser zum Beispiel mit der Funktion <link linkend="domnode.appendchild">DOMNode->appendChild()</link> -eingefügt wird.'> +eingefügt wird.'> <!-- FileSystem entities --> -<!ENTITY fs.validfp.all '<para>Der Zeiger auf eine Datei muss gültig sein und +<!ENTITY fs.validfp.all '<para>Der Zeiger auf eine Datei muss gültig sein und auf eine Datei verweisen, die vorher erfolgreich mit <function>fopen</function> -oder <function>fsockopen</function> geöffnet (und nicht bereits von +oder <function>fsockopen</function> geöffnet (und nicht bereits von <function>fclose</function> geschlossen) wurde.</para>'> <!ENTITY fs.file.pointer '<para>Eine Dateisystem <type>resource</type> -wie sie in dr Regel von <function>fopen</function> zurückgegeben wird. +wie sie in dr Regel von <function>fopen</function> zurückgegeben wird. </para>'> <!-- Oracle --> <!ENTITY oci.charset "<para>Wenn Sie den Oracle Server in der Version 9.2 oder -höher benutzen, können Sie den Zeichensatz, der für eine neue Verbindung +höher benutzen, können Sie den Zeichensatz, der für eine neue Verbindung genutzt werden soll, mit dem <parameter>charset</parameter> Parameter angeben. Verwenden Sie Oracle in einer Version < 9.2 wird dieser Parameter ignoriert und stattdessen die Umgebungsvariable <literal>NLS_LANG</literal> benutzt.</para>"> -<!ENTITY oci.datatypes '<para>Für Details zur vom OCI8 Treiber durchgeführten -Umsetzung von Datentypen siehe die<link linkend="oci8.datatypes" ->vom Treiber unterstützen Datentypen</link></para>'> +<!ENTITY oci.datatypes '<para>Für Details zur vom OCI8 Treiber durchgeführten +Umsetzung von Datentypen siehe die <link linkend="oci8.datatypes" +>vom Treiber unterstützen Datentypen</link>.</para>'> <!-- PCNTL Notes --> <!ENTITY pcntl.parameter.status '<para>Der <parameter>status</parameter> -Parameter entspricht dem Statusparameter der für einen erfolgreichen Aufruf +Parameter entspricht dem Statusparameter der für einen erfolgreichen Aufruf von <function>pcntl_waitpid</function> verwendet wird.</para>'> <!-- XSLT Notes --> @@ -380,21 +380,21 @@ <!ENTITY note.sm.disabled '<note><simpara>&sm.disabled;</simpara></note>'> <!ENTITY note.sm.uidcheck '<note><simpara>Wenn <link -linkend="features.safe-mode">Safe Mode</link> aktiviert ist, überprüft PHP, +linkend="features.safe-mode">Safe Mode</link> aktiviert ist, überprüft PHP, ob die Dateien/Verzeichnisse die mit dem Skript bearbeitet werden sollen, -die gleiche UID (Eigentümer) haben wie das Skript selbst.</simpara></note>'> +die gleiche UID (Eigentümer) haben wie das Skript selbst.</simpara></note>'> <!ENTITY note.sm.uidcheck.dir '<note><simpara>Wenn <link -linkend="features.safe-mode">Safe Mode</link> aktiviert ist überprüft PHP ob -das Arbeitsverzeichnis, die gleiche UID (Eigentümer) hat wie das Skript selbst. +linkend="features.safe-mode">Safe Mode</link> aktiviert ist überprüft PHP ob +das Arbeitsverzeichnis, die gleiche UID (Eigentümer) hat wie das Skript selbst. </simpara></note>'> -<!ENTITY note.open-basedir.func '<note><para>Diese Funktion wird von <link +<!ENTITY note.open-basedir.func '<note><para>Diese Funktion wird von <link linkend="ini.open-basedir">open_basedir</link> beeinflusst.</para></note>'> <!ENTITY note.language-construct '<note><simpara>Da dies ein Sprachkonstrukt -und keine Funktion ist, deshalb können Sie dieses nicht mit +und keine Funktion ist, deshalb können Sie dieses nicht mit <link linkend="functions.variable-functions">Variablenfunktionen</link> verwenden.</simpara></note>'> @@ -403,8 +403,8 @@ should have been inline in safe-mode.xml --> -<!ENTITY sm.uidcheck 'Überprüft ob die Dateien/Verzeichnisse, die mit dem Skript -bearbeitet werden sollen, die gleiche UID Eigentümer haben wie das Skript +<!ENTITY sm.uidcheck 'Ãberprüft ob die Dateien/Verzeichnisse, die mit dem Skript +bearbeitet werden sollen, die gleiche UID Eigentümer haben wie das Skript selbst.'> <!ENTITY warn.sm.exec '<warning><simpara>Mit aktiviertem <link @@ -414,28 +414,28 @@ </simpara></warning>'> <!ENTITY note.exec-path '<note><simpara>Mit aktiviertem <link -linkend="features.safe-mode">Safe Mode</link> können Sie nur Programme -ausführen, die im Verzeichnis liegen, das mit <link +linkend="features.safe-mode">Safe Mode</link> können Sie nur Programme +ausführen, die im Verzeichnis liegen, das mit <link linkend="ini.safe-mode-exec-dir">safe_mode_exec_dir</link> angegeben wurde. Aus -praktischen Gründen ist es gegenwärtig nicht erlaubt, dass der Pfad zu einem -Programm <literal>..</literal> enthält.</simpara></note>'> +praktischen Gründen ist es gegenwärtig nicht erlaubt, dass der Pfad zu einem +Programm <literal>..</literal> enthält.</simpara></note>'> -<!ENTITY sm.uidcheck.dir 'Überprüft ob das Verzeichnis in dem das Skript -ausgeführt werden soll, die gleiche UID (Eigentümer) hat wie das Skript selbst.'> +<!ENTITY sm.uidcheck.dir 'Ãberprüft ob das Verzeichnis in dem das Skript +ausgeführt werden soll, die gleiche UID (Eigentümer) hat wie das Skript selbst.'> <!ENTITY sm.disabled 'Diese Funktion steht im <link -linkend="features.safe-mode">Safe Mode</link> nicht zur Verfügung.'> +linkend="features.safe-mode">Safe Mode</link> nicht zur Verfügung.'> <!-- Common pieces in partintro-sections --> <!ENTITY no.config '<para>Diese Erweiterung definiert keine Konfigurationseinstellungen in der &php.ini;.</para>'> <!ENTITY no.resource '<para>Diese Erweiterung definiert keine Resource-Typen.</para>'> <!ENTITY no.constants '<para>Diese Erweiterung definiert keine Konstanten.</para>'> -<!ENTITY no.requirement '<para>Diese Erweiterung benötigt keine externen Bibliotheken.</para>'> -<!ENTITY no.install '<para>Für diese Funktionen ist keine Installation erforderlich, -diese gehören zum Grundbestand von PHP.</para>'> +<!ENTITY no.requirement '<para>Diese Erweiterung benötigt keine externen Bibliotheken.</para>'> +<!ENTITY no.install '<para>Für diese Funktionen ist keine Installation erforderlich, +diese gehören zum Grundbestand von PHP.</para>'> <!-- Used in every chapter that has directive descriptions --> -<!ENTITY ini.descriptions.title '<para>Hier eine kurze Erklärung der +<!ENTITY ini.descriptions.title '<para>Hier eine kurze Erklärung der Konfigurationsoptionen:</para>'> <!-- Common pieces for reference part BEGIN--> @@ -449,31 +449,31 @@ <!-- Used in reference/$extname/constants.xml --> <!ENTITY extension.constants '<simpara>Folgende Konstanten werden von dieser -Erweiterung definiert und stehen nur zur Verfügung, wenn die Erweiterung entweder +Erweiterung definiert und stehen nur zur Verfügung, wenn die Erweiterung entweder statisch in PHP kompiliert oder dynamisch zur Laufzeit geladen wurde. </simpara>'> <!-- For STANDARD Constants used in reference/$extname/constants.xml --> <!ENTITY extension.constants.core '<simpara>Die aufgelisteten Konstanten -stehen immer zur Verfügung, da sie zum Grundbestand von PHP gehören.</simpara>'> +stehen immer zur Verfügung, da sie zum Grundbestand von PHP gehören.</simpara>'> <!-- Used in reference/$extname/classes.xml --> <!ENTITY extension.classes '<simpara>Folgende Klassen werden von dieser -Erweiterung definiert und stehen nur zur Verfügung, wenn die Erweiterung +Erweiterung definiert und stehen nur zur Verfügung, wenn die Erweiterung entweder statisch in PHP kompiliert oder dynamisch zur Laufzeit geladen wurde. </simpara>'> -<!ENTITY note.extension.php5 '<note><simpara> Diese Erweiterung benötigt +<!ENTITY note.extension.php5 '<note><simpara> Diese Erweiterung benötigt PHP 5.</simpara></note>'> <!-- PDO entities --> <!ENTITY pdo.driver-constants '<simpara>Die folgenden Konstanten werden vom Treiber -definiert und sind nur verfügbar wenn die Extension entweder in PHP einkompiliert -oder dynamisch zur Laufzeit geladen wurde. Weiterhin sind diese Konstanten +definiert und sind nur verfügbar wenn die Extension entweder in PHP einkompiliert +oder dynamisch zur Laufzeit geladen wurde. Weiterhin sind diese Konstanten treiberspezifisch und sollten nur mit diesem Treiber benutzt werden. MySQL-spezifische Attribute mit dem PostgreSQL Treiber zu nutzen kann zu unerwarteten Ergebnissen -führen. Kann Ihr Code mit verschiedenen Treibern arbeiten so können Sie -<function>PDO::getAttribute</function> benutzen um mit +führen. Kann Ihr Code mit verschiedenen Treibern arbeiten so können Sie +<function>PDO::getAttribute</function> benutzen um mit <constant>PDO_ATTR_DRIVER_NAME</constant> den aktuellen Treiber zu ermitteln. </simpara>'> @@ -484,40 +484,40 @@ <!ENTITY pecl.bundled 'Diese <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl;">PECL</link> Erweiterung ist Teil von PHP.'> -<!ENTITY pecl.info 'Information zur Installation dieser PECL Extension +<!ENTITY pecl.info 'Information zur Installation dieser PECL Extension finden sie im Kapitel <link linkend="install.pecl">Installation von PECL Extensions</link>. -Zusätzliche Informationen, wie neue Releases, Downloads +Zusätzliche Informationen, wie neue Releases, Downloads Quelldateien, Maintainerinformation und ein CHANGELOG finden Sie hier: '> -<!ENTITY pecl.source.4 'Für PHP 4 finden Sie die Quellen dieser +<!ENTITY pecl.source.4 'Für PHP 4 finden Sie die Quellen dieser <acronym>PECL</acronym> Erweiterung im <filename>ext/</filename> Verzeichnis innerhalb der PHP Quellen oder unter dem <acronym>PECL</acronym> Link wie oben angegeben.'> -<!ENTITY pecl.windows.4 'Für PHP 4 finden Sie die <acronym>DLL</acronym> im -<filename>extensions/</filename> Verzeichnis der PHP Windows Binärdistribution.'> +<!ENTITY pecl.windows.4 'Für PHP 4 finden Sie die <acronym>DLL</acronym> im +<filename>extensions/</filename> Verzeichnis der PHP Windows Binärdistribution.'> -<!ENTITY pecl.windows.download ' Sie können die <acronym>DLL</acronym> für +<!ENTITY pecl.windows.download ' Sie können die <acronym>DLL</acronym> für diese <acronym>PECL</acronym> Erweiterung entweder von <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.php.downloads;">PHP Downloads</link> oder von <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl.win;">&url.pecl.win;</link> herunterladen.'> -<!ENTITY pecl.windows.download.unbundled 'Einzelne <acronym>PECL</acronym> Extensions können von -den <acronym>PECL</acronym> Schnappschussseiten heruntergeladen werden (wählen Sie das geeignete -Repository für <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl.win;">&url.pecl.win;</link>'> +<!ENTITY pecl.windows.download.unbundled 'Einzelne <acronym>PECL</acronym> Extensions können von +den <acronym>PECL</acronym> Schnappschussseiten heruntergeladen werden (wählen Sie das geeignete +Repository für <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl.win;">&url.pecl.win;</link>'> -<!ENTITY pecl.moved-ver 'Diese Erweiterung wurde ins <link xmlns:xlink="http://www.w3.org/1999/xlink" +<!ENTITY pecl.moved-ver 'Diese Erweiterung wurde ins <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl;">PECL</link> Repositorium verschoben und ist nicht mehr Teil von PHP ab PHP '> <!-- kept for BC --> <!ENTITY note.pecl-php5 '<note><simpara> Diese Erweiterung wurde aus der Distribution von PHP 5 entfernt und steht in -<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl;">PECL</link> zur Verfügung.</simpara></note>'> +<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl;">PECL</link> zur Verfügung.</simpara></note>'> <!-- Common pieces for reference part END --> -<!ENTITY windows.builtin '<simpara>Die Windowsversion von PHP enthält diese -Erweiterung. Um diese Funktionen zu verwenden, müssen Sie keine zusätzlichen +<!ENTITY windows.builtin '<simpara>Die Windowsversion von PHP enthält diese +Erweiterung. Um diese Funktionen zu verwenden, müssen Sie keine zusätzlichen Erweiterungen aktivieren.</simpara>'> <!-- These are here as helpers for manual consistency and brievety--> @@ -530,111 +530,111 @@ debug_level</parameter></term><listitem><para>Ein aus der Addition von <literal>XXX_TRACE</literal> Konstanten gewonnener Integerwert.</para> <para>. Von der Verwendung der <constant>MEMORY_TRACE</constant> Konstante -wird abgeraten da diese die Ausführung sehr verlangsamt und keine genauen +wird abgeraten da diese die Ausführung sehr verlangsamt und keine genauen Ergebnisse zu liefern scheint. <constant>ASSIGNMENT_TRACE</constant> ist -noch nicht implementiert.</para><para>Um alle funktioierenden Traces -(TIMING, FUNCTIONS, ARGS SUMMARY (ähnlich zu strace -c)) zu aktivieren +noch nicht implementiert.</para><para>Um alle funktioierenden Traces +(TIMING, FUNCTIONS, ARGS SUMMARY (ähnlich zu strace -c)) zu aktivieren benutzen Sie den Wert 99</para></listitem></varlistentry>'> <!-- BCMath Notes --> <!ENTITY bc.scale.description '<varlistentry><term><parameter> scale</parameter></term><listitem><para>Dieser optionale Parameter kann benutzt werden um die Anzahl der Nachkommastellen im Ergebnis -festzulegen. Sie können mit Hilfe der <function>bcscale</function> -Funktion auch einen globalen Vorgabewert für alle Funktionen +festzulegen. Sie können mit Hilfe der <function>bcscale</function> +Funktion auch einen globalen Vorgabewert für alle Funktionen festlegen.</para></listitem></varlistentry>'> <!-- FBSQL Notes --> <!ENTITY fbsql.link-identifier.description '<varlistentry><term><parameter> -link_identifier</parameter></term><listitem><para>Eine von +link_identifier</parameter></term><listitem><para>Eine von <function>fbsql_connect</function> oder <function>fbsql_pconnect</function> -zurückgegebe FrontBase-Verbindung.</para><para>Wenn optional und nicht -angegeben wird versucht eine bereits geöffnete FrontBase Verbindung gesucht, -falls keine vorhanden ist wird versucht eine zu öffnen als ob +zurückgegebe FrontBase-Verbindung.</para><para>Wenn optional und nicht +angegeben wird versucht eine bereits geöffnete FrontBase Verbindung gesucht, +falls keine vorhanden ist wird versucht eine zu öffnen als ob <function>fbsql_connect</function> ohne Parameter aufgerufen wurde </para></listitem></varlistentry>'> - + <!ENTITY fbsql.result.description '<varlistentry><term><parameter> result</parameter></term><listitem><para>Ein von <function>fbsql_query</function> -zurückgegebenes Erebnishandle.</para></listitem></varlistentry>'> +zurückgegebenes Erebnishandle.</para></listitem></varlistentry>'> <!-- GMP Notes --> -<!ENTITY gmp.return 'Eine <type>resource</type> für einen GMP Wert.'> +<!ENTITY gmp.return 'Eine <type>resource</type> für einen GMP Wert.'> <!ENTITY gmp.parameter '<para>Dies kann entweder eine <type>resource</type> -für einen GMP Wert sein oder ein numerischer String wenn es möglich ist +für einen GMP Wert sein oder ein numerischer String wenn es möglich ist diesen in einen GMP Wert umzuwandeln.</para>'> - + <!-- MySQLi Notes --> <!ENTITY mysqli.result.description '<varlistentry><term><parameter> result</parameter></term><listitem><para>Nur bei prozeduralem Aufruf: Ein von <function>mysqli_query</function>, <function>mysqli_store_result</function> -oder <function>mysqli_use_result</function> zurückgegebenes Ergebnisobjekt. +oder <function>mysqli_use_result</function> zurückgegebenes Ergebnisobjekt. </para></listitem></varlistentry>'> <!ENTITY mysqli.link.description '<varlistentry><term><parameter> link</parameter></term><listitem><para>Nur bei prozeduralem Aufruf: Ein von <function>mysqli_connect</function> oder <function>mysqli_init</function> -zurückgegebenes Verbindungsobjekt.</para></listitem></varlistentry>'> +zurückgegebenes Verbindungsobjekt.</para></listitem></varlistentry>'> <!ENTITY mysqli.stmt.description '<varlistentry><term><parameter> stmt</parameter></term><listitem><para>Nur bei prozeduralem Aufruf: ein von -<function>mysqli_stmt_init</function> zurückgegebens Statementobjekt.</para> +<function>mysqli_stmt_init</function> zurückgegebens Statementobjekt.</para> </listitem></varlistentry>'> <!-- Notes for SAPI/Apache --> -<!ENTITY note.apache.nsapi-module '<note><para>Ab PHP 4.3.3 können Sie diese -Funktion auch mit dem <link linkend="ref.nsapi">NSAPI Server Modul</link> für +<!ENTITY note.apache.nsapi-module '<note><para>Ab PHP 4.3.3 können Sie diese +Funktion auch mit dem <link linkend="ref.nsapi">NSAPI Server Modul</link> für Netscape/iPlanet/SunONE Webserver nutzen.</para></note>'> -<!ENTITY apache.req.module '<simpara>Diese Funktion wird nur unterstützt, wenn +<!ENTITY apache.req.module '<simpara>Diese Funktion wird nur unterstützt, wenn PHP als Apache-Modul installiert wurde.</simpara>'> <!-- SimpleXML Notes --> -<!ENTITY simplexml.iteration '<note><simpara>SimpleXML definiert für die -meisten Methoden Regeln für das Hinzufügen von iterativen Eigenschaften. Diese -können weder mit <function>var_dump</function> oder auf andere Weise angezeigt +<!ENTITY simplexml.iteration '<note><simpara>SimpleXML definiert für die +meisten Methoden Regeln für das Hinzufügen von iterativen Eigenschaften. Diese +können weder mit <function>var_dump</function> oder auf andere Weise angezeigt werden.</simpara></note>'> <!-- SQLite Notes --> -<!ENTITY sqlite.case-fold '<para>Die Groß- und Kleinschreibung der +<!ENTITY sqlite.case-fold '<para>Die GroÃ- und Kleinschreibung der Spaltennamen, die von <literal>SQLITE_ASSOC</literal> und -<literal>SQLITE_BOTH</literal> zurückgegeben werden, wird entsprechend der +<literal>SQLITE_BOTH</literal> zurückgegeben werden, wird entsprechend der Konfigurationsdirektive <link -linkend="ini.sqlite.assoc-case">sqlite.assoc_case</link> geändert.</para>'> +linkend="ini.sqlite.assoc-case">sqlite.assoc_case</link> geändert.</para>'> <!ENTITY sqlite.decode-bin '<para>Falls der Parameter <parameter>decode_binary</parameter> auf &true; gesetzt ist (das ist die -Standardeinstellung), dekodiert PHP die Binärkodierung, die bei Verwendung von +Standardeinstellung), dekodiert PHP die Binärkodierung, die bei Verwendung von <function>sqlite_escape_string</function> auf die Daten angewendet wird. -Solange Sie die Daten nicht mit anderen SQLite-Fähigen Applikationen teilen, +Solange Sie die Daten nicht mit anderen SQLite-Fähigen Applikationen teilen, sollten Sie diesen Wert in der Standardeinstellung lassen.</para>'> <!ENTITY sqlite.no-unbuffered '<note><para>Diese Funktion kann nicht mit ungepufferten Ergebnishandlern benutzt werden.</para></note>'> <!ENTITY sqlite.param-compat '<note><simpara>Zwei alternative Syntaxen werden -für die Kompatibilität mit anderen Datenbank-Erweiterungen (wie z.B. MySQL) -unterstützt. Die bevorzugte Form ist die erste, bei der der Parameter +für die Kompatibilität mit anderen Datenbank-Erweiterungen (wie z.B. MySQL) +unterstützt. Die bevorzugte Form ist die erste, bei der der Parameter <parameter>dbhandle</parameter> der erste Parameter der Funktion ist.</simpara></note>'> <!ENTITY sqlite.result-type '<para>Der optionale Parameter <parameter>Ergebnis_Typ</parameter> akzeptiert eine Konstante und bestimmt, -wie das zurückgegebene Array indiziert wird. Während mit +wie das zurückgegebene Array indiziert wird. Während mit <constant>SQLITE_ASSOC</constant> nur assoziative Indizes (Namensfelder) -zurückgegeben werden, werden mit <constant>SQLITE_NUM</constant> nur -numerische Indizes (geordnete Feldnummern) zurückgegeben. +zurückgegeben werden, werden mit <constant>SQLITE_NUM</constant> nur +numerische Indizes (geordnete Feldnummern) zurückgegeben. <constant>SQLITE_BOTH</constant> gibt sowohl assoziative als auch numerische -Indizes zurück. <constant>SQLITE_BOTH</constant> ist die +Indizes zurück. <constant>SQLITE_BOTH</constant> ist die Standardeinstellung.</para>'> <!-- Database Notes --> <!ENTITY database.field-case '<note><simpara>Feldnamen, die von dieser Funktion -zurückgegeben werden, unterscheiden sich in der -<emphasis>Groß-/Kleinschreibung</emphasis>.</simpara></note>'> +zurückgegeben werden, unterscheiden sich in der +<emphasis>GroÃ-/Kleinschreibung</emphasis>.</simpara></note>'> <!ENTITY database.fetch-null '<note><simpara>Diese Funktion setzt NULL Felder auf den PHP Wert &null;.</simpara></note>'> @@ -644,9 +644,9 @@ <!ENTITY msql.linkid.description '<varlistentry><term><parameter> Verbindungskennung</parameter></term><listitem><para>Die mSQL-Verbindung. Wird keine Verbindungskennung angegeben, wird die letzte durch -<function>msql_connect</function> geöffnete Verbindung angenommen. Falls +<function>msql_connect</function> geöffnete Verbindung angenommen. Falls keine solche Verbindung gefunden wird, versucht die Funktion, eine Verbindung -so aufzubauen, als wäre <function>msql_connect</function> aufgerufen worden +so aufzubauen, als wäre <function>msql_connect</function> aufgerufen worden und verwendet diese.</para></listitem></varlistentry>'> <!ENTITY msql.result.description '<varlistentry><term><parameter> @@ -665,10 +665,10 @@ <!ENTITY mysql.linkid.description '<varlistentry><term><parameter> Verbindungs-Kennung</parameter></term><listitem><para>Die MySQL-Verbindung. Wird die Verbindungskennung nicht angegeben, wird die letzte durch -<function>mysql_connect</function> geöffnete Verbindung angenommen. Falls +<function>mysql_connect</function> geöffnete Verbindung angenommen. Falls keine solche Verbindung gefunden wird, wird versucht, eine Verbindung aufzubauen, wie es beim Aufruf von <function>mysql_connect</function> ohne -Angabe von Argumenten der Fall wäre. Falls zufällig keine Verbindung gefunden +Angabe von Argumenten der Fall wäre. Falls zufällig keine Verbindung gefunden oder aufgebaut werden kann, wird eine Warnung der Stufe <constant>E_WARNING</constant> erzeugt.</para></listitem></varlistentry>'> @@ -685,115 +685,115 @@ <constant>E_WARNING</constant> erzeugt.</para></listitem></varlistentry>'> <!-- Sybase Notes --> -<!ENTITY sybase.ct.only '<note><simpara>Diese Funktion steht nur zur Verfügung, +<!ENTITY sybase.ct.only '<note><simpara>Diese Funktion steht nur zur Verfügung, wenn Sie die CT Bibliothek als Schnittstelle zu Sybase verwenden. </simpara></note>'> -<!ENTITY sybase.db.only '<note><simpara>Diese Funktion steht nur zur Verfügung, +<!ENTITY sybase.db.only '<note><simpara>Diese Funktion steht nur zur Verfügung, wenn Sie die DB Bibliothek als Schnittstelle zu Sybase verwenden.</simpara></note>'> <!ENTITY sybase.linkid.description '<varlistentry><term><parameter> link_identifier</parameter></term><listitem><para>Die Sybase Verbindung. -Wird keine Verbindung angegeben so wird die letzte mit -<function>sybase_connect</function> geöffnete Verbindung angenommen. +Wird keine Verbindung angegeben so wird die letzte mit +<function>sybase_connect</function> geöffnete Verbindung angenommen. Wird keine solche Verbindung gefunden wird versucht eine Verbindung -so zu öffnen als ob <function>sybase_connect</function> ohne Parameter -aufgerufen wurde. Kann keine Verbindung gefunden oder geöffnet werden +so zu öffnen als ob <function>sybase_connect</function> ohne Parameter +aufgerufen wurde. Kann keine Verbindung gefunden oder geöffnet werden so wird eine <constant>E_WARNING</constant> Warnung generiert.</para></listitem> </varlistentry>'> <!-- CPDF Notes --> <!ENTITY cpdf.ul '<para>Der optionale Parameter <parameter>mode</parameter> -bestimmt die Länge der Einheit. Ist dieser gleich 0 oder nicht angegeben, -wird die Standardeinheit benutzt die für die Seite angegeben wurde. +bestimmt die Länge der Einheit. Ist dieser gleich 0 oder nicht angegeben, +wird die Standardeinheit benutzt die für die Seite angegeben wurde. Andernfalls werden die Koordinaten in Postscript Punkten ohne Beachtung der aktuellen Einheit gemessen.</para>'> <!ENTITY cpdf.mode.description '<varlistentry><term><parameter> mode</parameter></term><listitem><para>Der optionale Parameter <parameter>mode</parameter> bestimmt die Masseinheit. Wenn er -0 ist oder nicht übergeben wurde wird die Standardmaßeinheit des -Dokuments benutzt, ansonsten werden Koordinaten in PostScript -Punkten gemessen und die Standardmaßeinheit ignoriert. +0 ist oder nicht übergeben wurde wird die StandardmaÃeinheit des +Dokuments benutzt, ansonsten werden Koordinaten in PostScript +Punkten gemessen und die StandardmaÃeinheit ignoriert. </para></listitem></varlistentry>'> - + <!ENTITY cpdf.pdf-document.description '<varlistentry><term><parameter> -pdf_document</parameter></term><listitem><para>Das von +pdf_document</parameter></term><listitem><para>Das von <function>cpdf_open</function> gelieferte Dokument-Handle.</para> </listitem></varlistentry>'> <!-- Xattr entities --> <!ENTITY xattr.namespace '<para>Erweiterte Eigenschaften haben zwei -verschiedene Namensräume: den User- und den Root-Namensraum. Der -User-Namensraum steht allen Benutzern zur Verfügung während der -Root-Namensraum nur Benutzern mit Root-Rechten zur Verfügung steht. xattr -operiert standardmäßig im User-Namensraum, aber das können Sie mit dem -Parameter <parameter>flags</parameter> ändern.</para>'> +verschiedene Namensräume: den User- und den Root-Namensraum. Der +User-Namensraum steht allen Benutzern zur Verfügung während der +Root-Namensraum nur Benutzern mit Root-Rechten zur Verfügung steht. xattr +operiert standardmäÃig im User-Namensraum, aber das können Sie mit dem +Parameter <parameter>flags</parameter> ändern.</para>'> <!-- Notes for IPv6 --> <!ENTITY ipv6.brackets '<note><simpara>Wenn Sie eine numerische IPv6 Adresse -angeben, z.B.: <literal>fe80::1</literal>, müssen Sie die IP in eckige Klammern +angeben, z.B.: <literal>fe80::1</literal>, müssen Sie die IP in eckige Klammern schreiben, z.B: <literal>tcp://[fe80::1]:80</literal>.</simpara></note>'> -<!ENTITY ipv6.php5 '<note><simpara>IPv6 Unterstützung steht seit PHP 5.0.0 zur -Verfügung.</simpara></note>'> +<!ENTITY ipv6.php5 '<note><simpara>IPv6 Unterstützung steht seit PHP 5.0.0 zur +Verfügung.</simpara></note>'> <!-- Notes for tidy --> <!ENTITY note.tidy.ze2 '<note><simpara> Diese Funktion wird nur von der Zend -Engine 2 (PHP >= 5.0.0) unterstützt.</simpara></note>'> +Engine 2 (PHP >= 5.0.0) unterstützt.</simpara></note>'> <!ENTITY note.tidy.1only '<note><simpara>Diese Funktion steht nur in Tidy 1.0 -zur Verfügung. In Tidy 2.0 ist diese Funktion obsolet und wurde entfernt. +zur Verfügung. In Tidy 2.0 ist diese Funktion obsolet und wurde entfernt. </simpara></note>'> <!ENTITY note.tidy.2only '<note><simpara>Die optionalen Parameter <parameter>config</parameter> und <parameter>encoding</parameter> stehen seit -Tidy 2.0 zur Verfügung.</simpara></note>'> +Tidy 2.0 zur Verfügung.</simpara></note>'> <!ENTITY tidy.conf-enc '<para>Den <parameter>config</parameter> Parameter -können Sie entweder als Array oder String übergeben. Bei der Übergabe als +können Sie entweder als Array oder String übergeben. Bei der Ãbergabe als String wird dieser als Name der Konfigurationsdatei interpretiert, bei der -Übergabe als Array als die Optionen selbst. Für möegliche Optionen und deren +Ãbergabe als Array als die Optionen selbst. Für möegliche Optionen und deren Bedeutung sollten Sie sich <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.tidy.conf;">&url.tidy.conf;</link> anschauen.</para><para>Der <parameter>encoding</parameter> Parameter bestimmt -die Kodierung für die Ein- und Ausgabe von Dokumenten. Mögliche Werte für -<parameter>encoding</parameter>: <literal>ascii</literal>, <literal>latin0</literal>, -<literal>latin1</literal>, <literal>raw</literal>, <literal>utf8</literal>, -<literal>iso2022</literal>, <literal>mac</literal>, <literal>win1252</literal>, -<literal>ibm858</literal>, <literal>utf16</literal>, <literal>utf16le</literal>, -<literal>utf16be</literal>, <literal>big5</literal> und +die Kodierung für die Ein- und Ausgabe von Dokumenten. Mögliche Werte für +<parameter>encoding</parameter>: <literal>ascii</literal>, <literal>latin0</literal>, +<literal>latin1</literal>, <literal>raw</literal>, <literal>utf8</literal>, +<literal>iso2022</literal>, <literal>mac</literal>, <literal>win1252</literal>, +<literal>ibm858</literal>, <literal>utf16</literal>, <literal>utf16le</literal>, +<literal>utf16be</literal>, <literal>big5</literal> und <literal>shiftjis</literal>.</para>'> <!-- Snippets for the installation section --> <!ENTITY warn.apache2.compat '<warning><para>Wir empfehlen, in einer Produktionsumgebung kein Threaded MPM mit Apache2 zu verwenden. Verwenden Sie -stattdessen das Prefork MPM oder Apache1. Für weitere Informationen und die -Gründe lesen Sie bitte den entsprechenden FAQ-Eintrag über die Verwendung von +stattdessen das Prefork MPM oder Apache1. Für weitere Informationen und die +Gründe lesen Sie bitte den entsprechenden FAQ-Eintrag über die Verwendung von <link linkend="faq.installation.apache2">Apache2 mit Threaded MPM.</link></para></warning>'> <!ENTITY note.apache.slashes '<note><simpara>Beachten Sie bitte, dass Sie bei Pfadangaben in der Apachekonfigurationsdatei unter Windows alle Backslashes, -wie z.B. <filename>c:\directory\file.ext</filename>, in Schrägstriche umwandeln -müssen: <filename>c:/directory/file.ext</filename>. Bei Verzeichnisnamen -kann weiterhin ein abschließender Schrägstrich nötig sein.</simpara></note>'> +wie z.B. <filename>c:\directory\file.ext</filename>, in Schrägstriche umwandeln +müssen: <filename>c:/directory/file.ext</filename>. Bei Verzeichnisnamen +kann weiterhin ein abschlieÃender Schrägstrich nötig sein.</simpara></note>'> <!-- Snippets and titles for the contributors section --> <!ENTITY Credit.Authors.and.Contributors 'Autoren und Mitwirkende'> <!ENTITY Credit.Introduction '<para>Wir heben die zur Zeit aktivsten Personen auf der Titelseite des Handbuchs hervor, aber es gibt viel mehr Mitwirkende, -die zurzeit mithelfen oder in der Vergangenheit einen großen Beitrag zu diesem +die zurzeit mithelfen oder in der Vergangenheit einen groÃen Beitrag zu diesem Projekt geleistet haben. Ebenfalls gibt es eine Vielzahl von Personen, die hier -nicht namentlich aufgeführt sind, die durch ihre User Notes auf den +nicht namentlich aufgeführt sind, die durch ihre User Notes auf den Handbuchseiten mithelfen. Die User Notes werden kontinuierlich in unser -Handbuch integriert und wir schätzen diese Unterstützung außerordentlich. +Handbuch integriert und wir schätzen diese Unterstützung auÃerordentlich. Alle folgenden Listen sind alphabetisch sortiert.</para>'> <!ENTITY Credit.Authors.and.Editors 'Autoren und Editoren'> <!ENTITY Credit.Past.Authors.Text 'Folgende Personen verdienenen Anerkennung -dafür, dass Sie wesentlichen Inhalt zum Handbuch beigetragen haben und/oder weiterhin +dafür, dass Sie wesentlichen Inhalt zum Handbuch beigetragen haben und/oder weiterhin beitragen werden:'> <!ENTITY Credit.Past.Editors.Text 'Folgende Personen haben @@ -804,7 +804,7 @@ <!ENTITY Credit.Note.Editors.Active 'Die zurzeit aktivsten Betreuer:'> <!ENTITY Credit.Note.Editors.Inactive 'Auch folgende Personen haben -einiges an Mühe und Zeit zur Betreuung der User Notes investiert:'> +einiges an Mühe und Zeit zur Betreuung der User Notes investiert:'> <!ENTITY listendand ' und'> @@ -814,40 +814,40 @@ method.</simpara></note>'> <!ENTITY note.runkit.selfmanipulation '<note><simpara> Diese Funktion kann nicht -genutzt werden um die aktuell ausgeführte (oder verkette) Methode zu manipulieren. +genutzt werden um die aktuell ausgeführte (oder verkette) Methode zu manipulieren. </simpara></note>'> -<!ENTITY note.runkit.sandbox '<note><simpara>Sandbox Unterstützung -(wird benötigt für <function>runkit_lint</function>, <function>runkit_lint_file</function>, -und die <classname>Runkit_Sandbox</classname> Klasse) ist nur ab PHP 5.1 +<!ENTITY note.runkit.sandbox '<note><simpara>Sandbox Unterstützung +(wird benötigt für <function>runkit_lint</function>, <function>runkit_lint_file</function>, +und die <classname>Runkit_Sandbox</classname> Klasse) ist nur ab PHP 5.1 und speziell gepatchten Versionen -von PHP 5.0 verfügbar und setzt voraus das Thread-Unterstützung aktiviert wurde. -Weiterführende Informationen finden sie in der README Datei des runkit Packets. +von PHP 5.0 verfügbar und setzt voraus das Thread-Unterstützung aktiviert wurde. +Weiterführende Informationen finden sie in der README Datei des runkit Packets. See the README file included in the runkit package for more information. </simpara></note>'> -<!ENTITY note.runkit.internal-override '<note><simpara>Normalerweise können -nur benutzerdefinierte Funktionen gelöscht, umbenannt oder modifiziert werden. -Wenn Sie auch interne Funktionen übersteuern wollen müssen Sie +<!ENTITY note.runkit.internal-override '<note><simpara>Normalerweise können +nur benutzerdefinierte Funktionen gelöscht, umbenannt oder modifiziert werden. +Wenn Sie auch interne Funktionen übersteuern wollen müssen Sie <literal>runkit.internal_override</literal> in Ihrer &php.ini; aktivieren.</simpara></note>'> <!-- SSH2 Extension --> <!ENTITY note.ssh2.subsystem.publickey '<note><simpara> -Das Publickey Subsystem wird benötigt um öffentliche Schlüssel -auf einem Server zu verwalten für welche der Client -<emphasis>bereits authentifiziert ist</emphasis>. -Sie können sich gegenüber einem anderen System mit Publickey -Authentifizierung authentifizieren indem sie die +Das Publickey Subsystem wird benötigt um öffentliche Schlüssel +auf einem Server zu verwalten für welche der Client +<emphasis>bereits authentifiziert ist</emphasis>. +Sie können sich gegenüber einem anderen System mit Publickey +Authentifizierung authentifizieren indem sie die <function>ssh2_auth_pubkey_file</function> nutzen. </simpara></note>'> <!-- HTTP --> -<!ENTITY see.http.request.options '<para>Siehe auch die vollständige Liste der +<!ENTITY see.http.request.options '<para>Siehe auch die vollständige Liste der &link.http.request.options;.</para>'> - -<!ENTITY see.http.configuration.force_exit '&link.http.configuration; beschreibt was "beendet" in + +<!ENTITY see.http.configuration.force_exit '&link.http.configuration; beschreibt was "beendet" in diesem Zusammenhang bedeutet.'> <!ENTITY link.http.configuration '<link linkend="http.configuration">INI Einstellungen</link>'> @@ -858,7 +858,7 @@ <!ENTITY link.http.request.info '<link linkend="http.request.info">Request/Response Information</link>'> -<!ENTITY returns.http.response 'Gibt die HTTP Antwort(en) als String zurück oder &false; bei Fehlern.'> +<!ENTITY returns.http.response 'Gibt die HTTP Antwort(en) als String zurück oder &false; bei Fehlern.'> <!ENTITY returns.http.false.orexits 'Liefert &false; oder <emphasis>beendet</emphasis> bei Erfolg'> @@ -867,13 +867,13 @@ <!ENTITY http.request.affects.any 'Beeinflusst alle Requestmethoden.'> <!ENTITY http.response.class.php51 'die <link linkend="class.httpresponse"><classname ->HttpResponse</classname></link> Klasse wenn sie PHP 5.1 oder höher benutzen'> +>HttpResponse</classname></link> Klasse wenn sie PHP 5.1 oder höher benutzen'> -<!ENTITY http.maynotwork.SAPI 'Mit den folgenden SAPIs funktioniert dies evtl. nicht wie erwartet:This may not work as expected with the following SAPI(s):'> +<!ENTITY http.maynotwork.SAPI 'Mit den folgenden SAPIs funktioniert dies evtl. nicht wie erwartet:'> <!ENTITY http.content.disposition 'Der <literal>Content-Disposition</literal> ist hilfreich -wenn die gesendeten aus einer Datei oder einer ähnlichen Quelle stammen und vom Benutzer -oder Klienten gespeichert werden sollen (z.B. über den "Save as..." Dialog +wenn die gesendeten aus einer Datei oder einer ähnlichen Quelle stammen und vom Benutzer +oder Klienten gespeichert werden sollen (z.B. über den "Save as..." Dialog des Browsers).'> <!ENTITY http.use.ob_start 'Zur Nutzung mit <function>ob_start</function>.'> @@ -883,19 +883,19 @@ werden neu berechnet oder definiert.</simpara></note>'> <!ENTITY note.http.throttling.yields.process '<note><simpara>Stellt einen einfachen -Drosselungsmechanismus zur Verfügung der den aktuellen Prozess oder Thread stillegt -bis die Daten vollständig gesendet wurden.</simpara></note>'> +Drosselungsmechanismus zur Verfügung der den aktuellen Prozess oder Thread stillegt +bis die Daten vollständig gesendet wurden.</simpara></note>'> -<!ENTITY note.http.send.API '<note><simpara>Diese Funktion sollte zusammen mit -<function>http_send_data</function>, <function>http_send_file</function> +<!ENTITY note.http.send.API '<note><simpara>Diese Funktion sollte zusammen mit +<function>http_send_data</function>, <function>http_send_file</function> &listendand; <function>http_send_stream</function> benutzt werden.</simpara></note>'> <!ENTITY note.http.send.API.mayuse '<note><simpara>Diese Funktion kann zusammen mit -<function>http_send_data</function>, <function>http_send_file</function> +<function>http_send_data</function>, <function>http_send_file</function> &listendand; <function>http_send_stream</function> benutzt werden.</simpara></note>'> -<!ENTITY note.http.request.encodecookies '<note><simpara>Die &link.http.request.option; <literal>encodecookies</literal> +<!ENTITY note.http.request.encodecookies '<note><simpara>Die &link.http.request.option; <literal>encodecookies</literal> legt fest ob der Cookie-Wert mit <function>urlencode</function> kodiert werden soll..</simpara></note>'> <!ENTITY note.http.request.affects.any '<note><simpara>&http.request.affects.any;</simpara></note>'> @@ -904,25 +904,25 @@ <!-- XMLWriter Notes --> <!ENTITY xmlwriter.xmlwriter.description '<varlistentry><term><parameter> -xmlwriter</parameter></term><listitem><para>Nur für prozedurale Aufrufe. +xmlwriter</parameter></term><listitem><para>Nur für prozedurale Aufrufe. Die XMLWriter <type>resource</type> die bearbeitet werden soll. Diese -Resource wird von Aufrufen von <function>xmlwriter_open_uri</function> +Resource wird von Aufrufen von <function>xmlwriter_open_uri</function> oder <function>xmlwriter_open_memory</function> geliefert. </para></listitem></varlistentry>'> <!-- SVN notes --> -<!ENTITY svn.relativepath "<note><simpara>Relative Pfade werden so aufgelöst als ob -das aktuelle Verzeichnis das wäre in dem sich das PHP Binary befindet. Um statt dessen -das aktuelle Verzeichnis des aufrufenden Skripts zu nutzen müssen sie die -<function>realpath</function> Funktion oder dirname(__FILE__) zur Hilfe +<!ENTITY svn.relativepath "<note><simpara>Relative Pfade werden so aufgelöst als ob +das aktuelle Verzeichnis das wäre in dem sich das PHP Binary befindet. Um statt dessen +das aktuelle Verzeichnis des aufrufenden Skripts zu nutzen müssen sie die +<function>realpath</function> Funktion oder dirname(__FILE__) zur Hilfe ziehen.</simpara></note>"> <!ENTITY svn.referto.status 'Siehe auch <link linkend="svn.constants.status" ->Status-Konstanten</link> für mögliche Werte.'> +>Status-Konstanten</link> für mögliche Werte.'> <!ENTITY svn.referto.type 'Siehe auch <link linkend="svn.constants.type" ->Type-Konstanten</link> für mögliche Werte.'> - +>Type-Konstanten</link> für mögliche Werte.'> + <!-- Imagick generic return types --> <!ENTITY imagick.return.success 'Liefet &true; bei Erfolg.'> @@ -937,34 +937,34 @@ <!ENTITY note.openssl.cnf '<note xmlns="http://docbook.org/ns/docbook"> <simpara> - Die ordnungsgemäße Ausführung dieser Funktion setzt die Installation - einer gültigen <filename>openssl.cnf</filename> Datei voraus. + Die ordnungsgemäÃe Ausführung dieser Funktion setzt die Installation + einer gültigen <filename>openssl.cnf</filename> Datei voraus. Mehr Information hierzu finden sie im <link linkend="openssl.installation" >Installationsabschnitt</link>. </simpara> </note>'> <!ENTITY note.openssl.param-notext '<para xmlns="http://docbook.org/ns/docbook"> - Der optionale Parameter<parameter>notext</parameter> beinflusst die - Ausführlichkeit der Ausgabe. Wenn er auf &false; gesetzt wird werden - zusätzliche lesbare Informationen in die Ausgabe aufgenommen. Der - Vorgabewert für <parameter>notext</parameter> ist &true;. + Der optionale Parameter<parameter>notext</parameter> beinflusst die + Ausführlichkeit der Ausgabe. Wenn er auf &false; gesetzt wird werden + zusätzliche lesbare Informationen in die Ausgabe aufgenommen. Der + Vorgabewert für <parameter>notext</parameter> ist &true;. </para>'> <!-- COM/Dotnet --> <!ENTITY com.variant-arith '<note xmlns="http://docbook.org/ns/docbook"> <para> - Wie bei allen arithmetischen Variantfunktionen können die Parameter dieser - Funktion entweder native PHP Typen (Integer, String, Fließkomma, Boolean + Wie bei allen arithmetischen Variantfunktionen können die Parameter dieser + Funktion entweder native PHP Typen (Integer, String, FlieÃkomma, Boolean oder &null;) oder Instanzen einer COM, VARIANT oder DOTNET Klasse sein. Native PHP Typen werden nach den gleichen Regeln in Varianten umgewandelt wie auch im Konstruktor der <xref linkend="class.variant"/> Klasse. - Für COM und DOTNET Objekte wird der Wert ihrer Standardeigenschaft + Für COM und DOTNET Objekte wird der Wert ihrer Standardeigenschaft genommen und als Variantenwert genutzt. </para> <para> - Die arithmetischen Variantenfunktionen sind Wrapper für die ähnlich - benannten Funktionen der COM Bibliothek, weiterführende Informationen + Die arithmetischen Variantenfunktionen sind Wrapper für die ähnlich + benannten Funktionen der COM Bibliothek, weiterführende Informationen hierzu finden sie in der MSDN Bibliothek. Die PHP Funktionen sind leicht abweichend benannt, so korrespondiert <function>variant_add</function> in PHP zu VarAdd() in der MSDN Dokumentation. @@ -975,8 +975,8 @@ <!ENTITY com.use-oo-instead '<note xmlns="http://docbook.org/ns/docbook"> <simpara> Diese Funktion existiert nicht in PHP 5. Sie sollten statt dessen die - reguläre und natürlichere OO Syntax für Zugriffe auf Properties und - für Methodenaufrufe benutzen. + reguläre und natürlichere OO Syntax für Zugriffe auf Properties und + für Methodenaufrufe benutzen. </simpara> </note> '> @@ -984,8 +984,8 @@ <!-- phar --> <!ENTITY phar.write '<note xmlns="http://docbook.org/ns/docbook"> <para> - Diese Methode des <classname>Phar</classname> Objekts funktioniert nur - wenn die &php.ini; Einstellung <literal>phar.readonly</literal> auf 0 + Diese Methode des <classname>Phar</classname> Objekts funktioniert nur + wenn die &php.ini; Einstellung <literal>phar.readonly</literal> auf 0 gesetzt ist, sonst wird eine <classname>PharException</classname> geworfen. </para> </note>