cvs: phpdoc-de /reference/errorfunc/functions debug-backtrace.xml /reference/strings/functions number-format.xml parse-str.xml sscanf.xml strtok.xml
strtr.xml
| From: | Carola 'Sammy' Kummert | Date: | Tue, 01 Jul 2008 15:12:15 +0000 |
| Subject: | cvs: phpdoc-de /reference/errorfunc/functions debug-backtrace.xml /reference/strings/functions number-format.xml parse-str.xml sscanf.xml strtok.xml strtr.xml |
||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-2702@lists.php.net to get a copy of this message | ||
sammywg Tue Jul 1 15:12:15 2008 UTC
Modified files:
/phpdoc-de/reference/errorfunc/functions debug-backtrace.xml
/phpdoc-de/reference/strings/functions number-format.xml
parse-str.xml sscanf.xml
strtok.xml strtr.xml
Log:
sync to en,
encoding update
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/errorfunc/functions/debug-backtrace.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/errorfunc/functions/debug-backtrace.xml diff -u phpdoc-de/reference/errorfunc/functions/debug-backtrace.xml:1.6 phpdoc-de/reference/errorfunc/functions/debug-backtrace.xml:1.7 --- phpdoc-de/reference/errorfunc/functions/debug-backtrace.xml:1.6 Fri May 2 15:07:47 2008 +++ phpdoc-de/reference/errorfunc/functions/debug-backtrace.xml Tue Jul 1 15:12:15 2008 @@ -1,107 +1,107 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.18 Maintainer: fa Status: ready --> - <refentry xml:id="function.debug-backtrace" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>debug_backtrace</refname> - <refpurpose>Erzeugt Daten zur Ablaufverfolgung</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>debug_backtrace</methodname> - <void/> - </methodsynopsis> - <para> - <function>debug_backtrace</function> erzeugt Daten zur Ablaufverfolgung. - </para> - </refsect1> - - <refsect1 role="returnvalues"> - &reftitle.returnvalues; - <para> - Gibt ein assoziatives <type>Array</type> zurück. Als - zurückgegebene Arrayelemente von <function>debug_backtrace</function> - sind möglich: - </para> - <para> - <table> - <title>Mögliche Rückgabewerte von <function>debug_backtrace</function></title> - <tgroup cols="3"> - <thead> - <row> - <entry>Name</entry> - <entry>Typ</entry> - <entry>Beschreibung</entry> - </row> - </thead> - <tbody> - <row> - <entry>function</entry> - <entry><type>string</type></entry> - <entry> - Der Name der aktuell ausgeführten Funktion. Siehe auch - <link linkend="language.constants.predefined">__FUNCTION__</link>. - </entry> - </row> - <row> - <entry>line</entry> - <entry><type>integer</type></entry> - <entry> - Die aktuelle Zeilennummer. Siehe auch - <link linkend="language.constants.predefined">__LINE__</link>. - </entry> - </row> - <row> - <entry>file</entry> - <entry><type>string</type></entry> - <entry> - Der aktuelle Dateiname. Siehe auch - <link linkend="language.constants.predefined">__FILE__</link>. - </entry> - </row> - <row> - <entry>class</entry> - <entry><type>string</type></entry> - <entry> - Der aktuelle <link linkend="language.oop">class</link> - Name. Siehe auch - <link linkend="language.constants.predefined">__CLASS__</link>. - </entry> - </row> - <row> - <entry>object</entry> - <entry><type>object</type></entry> - <entry> - Das aktuelle <link linkend="language.oop">Objekt</link>. Dieses - Element ist seit PHP 5.1.1 verfügbar. - </entry> - </row> - <row> - <entry>type</entry> - <entry><type>string</type></entry> - <entry> - Der aktuelle Typ des Aufrufs. Falls der Aufruf in einer - Methode erfolgte, wird "->" zurückgegeben. Falls der Aufruf - aus einer statischen Funktion erfolgte, wird "::" - zurückgegeben und falls der Aufruf aus einer Funktion - erfolgte, wird nichts zurückgegeben. - </entry> - </row> - <row> - <entry>args</entry> - <entry><type>array</type></entry> - <entry> - Falls der Aufruf aus einer Funktion erfolgte, werden hier die - Funktionsargumente aufgelistet. Falls der Aufruf aus einer - eingebundenen Datei erfolgte, werden die Namen der - Include-Dateien angegeben. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.19 Maintainer: fa Status: ready --> + +<refentry xml:id="function.debug-backtrace" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>debug_backtrace</refname> + <refpurpose>Erzeugt Daten zur Ablaufverfolgung</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>debug_backtrace</methodname> + <methodparam choice="opt"><type>bool</type><parameter>provide_object</parameter></methodparam> + </methodsynopsis> + <para> + <function>debug_backtrace</function> erzeugt Daten zur Ablaufverfolgung. + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt ein assoziatives <type>Array</type> zurück. Als zurückgegebene + Arrayelemente von <function>debug_backtrace</function> sind möglich: + </para> + <para> + <table> + <title>Mögliche Rückgabewerte von <function>debug_backtrace</function></title> + <tgroup cols="3"> + <thead> + <row> + <entry>&Name;</entry> + <entry>&Type;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>function</entry> + <entry><type>string</type></entry> + <entry> + Der Name der aktuell ausgeführten Funktion. Siehe auch + <link linkend="language.constants.predefined">__FUNCTION__</link>. + </entry> + </row> + <row> + <entry>line</entry> + <entry><type>integer</type></entry> + <entry> + Die aktuelle Zeilennummer. Siehe auch + <link linkend="language.constants.predefined">__LINE__</link>. + </entry> + </row> + <row> + <entry>file</entry> + <entry><type>string</type></entry> + <entry> + Der aktuelle Dateiname. Siehe auch + <link linkend="language.constants.predefined">__FILE__</link>. + </entry> + </row> + <row> + <entry>class</entry> + <entry><type>string</type></entry> + <entry> + Der aktuelle <link linkend="language.oop">class</link> - Name. Siehe auch + <link linkend="language.constants.predefined">__CLASS__</link>. + </entry> + </row> + <row> + <entry>object</entry> + <entry><type>object</type></entry> + <entry> + Das aktuelle <link linkend="language.oop">Objekt</link>. + </entry> + </row> + <row> + <entry>type</entry> + <entry><type>string</type></entry> + <entry> + Der aktuelle Typ des Aufrufs. Falls der Aufruf in einer + Methode erfolgte, wird "->" zurückgegeben. Falls der Aufruf + aus einer statischen Funktion erfolgte, wird "::" + zurückgegeben und falls der Aufruf aus einer Funktion + erfolgte, wird nichts zurückgegeben. + </entry> + </row> + <row> + <entry>args</entry> + <entry><type>array</type></entry> + <entry> + Falls der Aufruf aus einer Funktion erfolgte, werden hier die + Funktionsargumente aufgelistet. Falls der Aufruf aus einer + eingebundenen Datei erfolgte, werden die Namen der + Include-Dateien angegeben. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> <refsect1 role="changelog"> &reftitle.changelog; @@ -116,9 +116,16 @@ </thead> <tbody> <row> + <entry>5.2.5</entry> + <entry> + Der optionale Parameter <parameter>provide_object</parameter> wurde + hinzugefügt. + </entry> + </row> + <row> <entry>5.1.1</entry> <entry> - Aktuelles <type>object</type> als möglichen Rückgabewert hinzugefügt. + Aktuelles <type>object</type> als möglichen Rückgabewert hinzugefügt. </entry> </row> </tbody> @@ -127,17 +134,17 @@ </para> </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - <example> - <title><function>debug_backtrace</function>-Beispiel</title> - <programlisting role="php"> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>debug_backtrace</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php -// Dateiname: /tmp/a.php +// Dateiname: a.php -function a_test($str) +function a_test($str) { echo "\nHi: $str"; var_dump(debug_backtrace()); @@ -151,11 +158,11 @@ include_once '/tmp/a.php'; ?> ]]> - </programlisting> - <para> - Ergebnisse beim Aufruf von <filename>/tmp/b.php</filename>: - </para> - <screen> + </programlisting> + <para> + Ergebnisse beim Aufruf von <filename>/tmp/b.php</filename>: + </para> + <screen> <![CDATA[ Hi: friend array(2) { @@ -173,7 +180,7 @@ array(4) { ["file"] => string(10) "/tmp/b.php" ["line"] => int(2) - ["args"] => + ["args"] => array(1) { [0] => string(10) "/tmp/a.php" } @@ -181,21 +188,22 @@ } } ]]> - </screen> - </example> - </para> - </refsect1> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>trigger_error</function></member> + <member><function>debug_print_backtrace</function></member> + </simplelist> + </para> + </refsect1> +</refentry> - <refsect1 role="seealso"> - &reftitle.seealso; - <para> - <simplelist> - <member><function>trigger_error</function></member> - <member><function>debug_print_backtrace</function></member> - </simplelist> - </para> - </refsect1> - </refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/number-format.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-de/reference/strings/functions/number-format.xml diff -u phpdoc-de/reference/strings/functions/number-format.xml:1.2 phpdoc-de/reference/strings/functions/number-format.xml:1.3 --- phpdoc-de/reference/strings/functions/number-format.xml:1.2 Sat Jun 23 13:21:49 2007 +++ phpdoc-de/reference/strings/functions/number-format.xml Tue Jul 1 15:12:15 2008 @@ -1,61 +1,118 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.10 Maintainer: sammywg Status: ready --> - <refentry xml:id="function.number-format" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>number_format</refname> - <refpurpose>Formatiert eine Zahl mit Tausender-Gruppierung</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>number_format</methodname> - <methodparam><type>float</type><parameter>number</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>decimals</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>dec_point</parameter></methodparam> - <methodparam><type>string</type><parameter>thousands_sep</parameter></methodparam> - </methodsynopsis> - <para> - <function>number_format</function> gibt eine formatierte Version von - <parameter>number</parameter> zurück. Die Funktion akzeptiert entweder - einen, zwei oder vier Parameter (nicht jedoch drei): - </para> - <para> - Wird nur ein Parameter übergeben, wird <parameter>number</parameter> - ohne Dezimalstellen, aber mit einem Komma (",") zur Gruppierung der - Tausenderstellen formatiert. - </para> - <para> - Wurden zwei Parameter übergeben, wird <parameter>number</parameter> als - Zahl mit <parameter>decimals</parameter> Dezimalstellen mit einem Punkt - (".") als Trennzeichen sowie einem Komma (",") zur Gruppierung der - Tausenderstellen formatiert. - </para> - <para> - Wenn alle vier Parameter übergeben wurden, wird <parameter>number</parameter> - als Zahl formatiert, die <parameter>decimals</parameter> Dezimalstellen hat, - die mittels <parameter>dec_point</parameter> anstelle des Punktes (".") - von der Zahl getrennt werden, und deren Tausenderstellen mittels - <parameter>thousands_sep</parameter> anstelle des Kommas (",") gruppiert - werden. - </para> - <para> - Nur das erste Zeichen von <parameter>thousands_sep</parameter> wird - verwendet. Wenn Sie beispielsweise <literal>bar</literal> für - <parameter>thousands_sep</parameter> auf die Zahl <literal>1000</literal> - anwenden, gibt Ihnen <function>number_format</function> - <literal>1b000</literal> zurück. - </para> - <para> - <example> - <title><function>number_format</function>-Beispiel</title> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.13 Maintainer: sammywg Status: ready --> + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.number-format" xmlns:xlink="http://www.w3.org/1999/xlink"> + <refnamediv> + <refname>number_format</refname> + <refpurpose>Formatiert eine Zahl mit Tausender-Gruppierung</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>number_format</methodname> + <methodparam><type>float</type><parameter>number</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>decimals</parameter></methodparam> + </methodsynopsis> + <methodsynopsis> + <type>string</type><methodname>number_format</methodname> + <methodparam><type>float</type><parameter>number</parameter></methodparam> + <methodparam><type>int</type><parameter>decimals</parameter></methodparam> + <methodparam><type>string</type><parameter>dec_point</parameter></methodparam> + <methodparam><type>string</type><parameter>thousands_sep</parameter></methodparam> + </methodsynopsis> + <para> + Die Funktion akzeptiert entweder einen, zwei oder vier Parameter + (nicht jedoch drei): + </para> + <para> + Wird nur ein Parameter übergeben, wird <parameter>number</parameter> + ohne Nachkommastellen, aber mit einem Komma (",") zur Gruppierung der + Tausenderstellen formatiert. + </para> + <para> + Wurden zwei Parameter übergeben, wird <parameter>number</parameter> als + Zahl mit <parameter>decimals</parameter> Nachkommastellen mit einem Punkt + (".") als Trennzeichen sowie einem Komma (",") zur Gruppierung der + Tausenderstellen formatiert. + </para> + <para> + Wenn alle vier Parameter übergeben wurden, wird <parameter>number</parameter> + als Zahl formatiert, die <parameter>decimals</parameter> Nachkommastellen + hat, die mittels <parameter>dec_point</parameter> anstelle des Punktes (".") + von der Zahl getrennt werden, und deren Tausenderstellen mittels + <parameter>thousands_sep</parameter> anstelle des Kommas (",") gruppiert + werden. + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Eine formatierte Version von <parameter>number</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>number</parameter></term> + <listitem> + <para> + Die zu formatierende Zahl. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>decimals</parameter></term> + <listitem> <para> - Beispielsweise notiert man in Frankreich normalerweise zwei - Dezimalstellen mit einem Komma (',') als Trennzeichen sowie ein - Leerzeichen (' ') zur Gruppierung der Tausender. Das kann durch folgende - Zeile erreicht werden: + Sets the number of decimal points. </para> - <programlisting role="php"> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dec_point</parameter></term> + <listitem> + <para> + Bestimmt das Trennzeichen für die Nachkommastellen. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>thousands_sep</parameter></term> + <listitem> + <para> + Bestimmt das Tausendertrennzeichen. + </para> + <para> + Nur das erste Zeichen von <parameter>thousands_sep</parameter> wird + verwendet. Wenn Sie beispielsweise <literal>bar</literal> für + <parameter>thousands_sep</parameter> auf die Zahl <literal>1000</literal> + anwenden, gibt Ihnen <function>number_format</function> + <literal>1b000</literal> zurück. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>number_format</function>-Beispiel</title> + <para> + Beispielsweise notiert man in Frankreich normalerweise zwei + Dezimalstellen mit einem Komma (',') als Trennzeichen sowie ein + Leerzeichen (' ') zur Gruppierung der Tausender. Das kann durch folgende + Zeile erreicht werden: + </para> + <programlisting role="php"> <![CDATA[ <?php @@ -77,18 +134,25 @@ ?> ]]> - </programlisting> - </example> - </para> - <para> - Siehe auch - <function>money_format</function>, - <function>sprintf</function>, - <function>printf</function> und - <function>sscanf</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>money_format</function></member> + <member><function>sprintf</function></member> + <member><function>printf</function></member> + <member><function>sscanf</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/parse-str.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/strings/functions/parse-str.xml diff -u phpdoc-de/reference/strings/functions/parse-str.xml:1.8 phpdoc-de/reference/strings/functions/parse-str.xml:1.9 --- phpdoc-de/reference/strings/functions/parse-str.xml:1.8 Thu Oct 25 18:52:23 2007 +++ phpdoc-de/reference/strings/functions/parse-str.xml Tue Jul 1 15:12:15 2008 @@ -1,10 +1,11 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.14 Maintainer: sammywg Status: ready --> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.15 Maintainer: sammywg Status: ready --> + <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.parse-str"> <refnamediv> <refname>parse_str</refname> - <refpurpose>Überträgt einen String in Variable</refpurpose> + <refpurpose>Ãberträgt einen String in Variable</refpurpose> </refnamediv> <refsect1 role="description"> @@ -16,7 +17,7 @@ </methodsynopsis> <para> Verarbeitet <parameter>str</parameter>, als ob er der Query-String - einer URL-Übergabe via GET wäre, und erstellt Variablen im aktuellen + einer URL-Ãbergabe via GET wäre, und erstellt Variablen im aktuellen Geltungsbereich. </para> <note> @@ -25,14 +26,14 @@ verwenden Sie am besten die Variable <link linkend="reserved.variables.server">$_SERVER['QUERY_STRING']</link>. Weitere Informationen finden Sie auch im Abschnitt <link - linkend="language.variables.external">Variablen außerhalb von PHP</link>. + linkend="language.variables.external">Variablen aus externen Quellen</link>. </para> </note> <note> <para> Die <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link>-Einstellungen beeinflussen die Ausgabe der Funktion, da <function>parse_str</function> - dieselben Mechanismen verwendet, die PHP zum Füllen von + dieselben Mechanismen verwendet, die PHP zum Füllen von <literal>$_GET</literal>, <literal>$_POST</literal> und anderen Variablen nutzt. </para> @@ -87,7 +88,7 @@ <row> <entry>4.0.3</entry> <entry> - Der Parameter <parameter>arr</parameter> wurde hinzugefügt. + Der Parameter <parameter>arr</parameter> wurde hinzugefügt. </entry> </row> </tbody> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/sscanf.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-de/reference/strings/functions/sscanf.xml diff -u phpdoc-de/reference/strings/functions/sscanf.xml:1.7 phpdoc-de/reference/strings/functions/sscanf.xml:1.8 --- phpdoc-de/reference/strings/functions/sscanf.xml:1.7 Wed Oct 24 22:20:05 2007 +++ phpdoc-de/reference/strings/functions/sscanf.xml Tue Jul 1 15:12:15 2008 @@ -1,82 +1,136 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.16 Maintainer: sammywg Status: ready --> - <refentry xml:id="function.sscanf" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>sscanf</refname> - <refpurpose> - Überträgt einen String in ein angegebenes Format - </refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>mixed</type><methodname>sscanf</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - <methodparam><type>string</type><parameter>format</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter role="reference">...</parameter></methodparam> - </methodsynopsis> - <para> - Die Funktion <function>sscanf</function> ist die Eingabe analog zu - <function>printf</function>. <function>sscanf</function> liest den String - <parameter>str</parameter> und interpretiert ihn entsprechend dem - angegebenen Parameter <parameter>format</parameter>, der in der - Dokumentation zu <function>sprintf</function> näher beschrieben ist. Werden - nur 2 Parameter an die Funktion übergeben, werden die analysierten Werte - als Array zurückgegeben. Andernfalls, wenn optionale Parameter beachtet - wurden, gibt die Funktion die Anzahl der ermittelten Werte zurück. Die - optionalen Parameter müssen referenziert übergeben werden. - </para> - <para> - Beliebige Whitespaces im Formatstring entsprechen beliebigen Whitespaces im - Inputstring. Das heißt, dass auch ein Tabulator \t im Formatstring einem - einzelnen Leerzeichen des Inputstrings entsprechen kann. - </para> - <para> - <example> - <title><function>sscanf</function>-Beispiel:</title> - <programlisting role="php"> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.17 Maintainer: sammywg Status: ready --> + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.sscanf" xmlns:xlink="http://www.w3.org/1999/xlink"> + <refnamediv> + <refname>sscanf</refname> + <refpurpose>Ãberträgt einen String in ein angegebenes Format</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>sscanf</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + <methodparam><type>string</type><parameter>format</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter role="reference">...</parameter></methodparam> + </methodsynopsis> + <para> + Die Funktion <function>sscanf</function> ist das Eingabegegenstück zu + <function>printf</function>. <function>sscanf</function> liest den String + <parameter>str</parameter> und interpretiert ihn entsprechend dem + übergegebenen <parameter>format</parameter>-Parameter , der in der + Dokumentation zu <function>sprintf</function> näher beschrieben ist. + </para> + <para> + Beliebige Whitespaces im Formatstring entsprechen beliebigen Whitespaces im + Inputstring. Das heiÃt, dass auch ein Tabulator \t im Formatstring einem + einzelnen Leerzeichen des Inputstrings entsprechen kann. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + Der zu parsende Eingabe<type>string</type>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>format</parameter></term> + <listitem> + <para> + Das interpretierte Format für <parameter>str</parameter>, wie es in der + Dokumentation zu <function>sprintf</function> beschrieben ist. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>...</parameter></term> + <listitem> + <para> + Optionale als Referenz übergebene Variablen, die die geparsten Werte + enthalten. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Werden nur 2 Parameter an die Funktion übergeben, werden die analysierten + Werte als Array zurückgegeben. Andernfalls, wenn optionale Parameter + übergeben wurden, gibt die Funktion die Anzahl der ermittelten Werte zurück. + Die optionalen Parameter müssen als Referenz übergeben werden. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>sscanf</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php // Ermittlung der Serien-Nr. -$serial = sscanf("SN/2350001","SN/%d"); +list($serial) = sscanf("SN/2350001", "SN/%d"); // und des Herstellungsdatums $mandate = "Januar 01 2000"; -list($monat, $tag, $jahr) = sscanf($mandate,"%s %d %d"); +list($monat, $tag, $jahr) = sscanf($mandate, "%s %d %d"); echo "Das Teil $serial wurde hergestellt am: " . "$jahr-" . substr($monat, 0, 3) . "-$tag\n"; ?> ]]> - </programlisting> - </example> - Werden optionale Parameter übergeben, gibt die Funktion die Anzahl - der ermittelten Werte zurück. - <example> - <title> - <function>sscanf</function> - Gebrauch optionaler Parameter</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + Werden optionale Parameter übergeben, gibt die Funktion die Anzahl + der ermittelten Werte zurück. + </para> + <para> + <example> + <title><function>sscanf</function> - Verwendung optionaler Parameter</title> + <programlisting role="php"> <![CDATA[ <?php -// Ermittlung der Autoren-Info und Erzeugung eines DocBook-Eintrages +// Auslesen der Autoren-Info und Erzeugung eines DocBook-Eintrages $auth = "24\tLewis Carroll"; -$n = sscanf($auth,"%d\t%s %s", &$id, &$first, &$last); +$n = sscanf($auth, "%d\t%s %s", $id, $first, $last); echo "<author id='$id'> <firstname>$first</firstname> <surname>$last</surname> </author>\n"; ?> ]]> - </programlisting> - </example> - </para> - <para> - Siehe auch - <function>fscanf</function>, - <function>printf</function> und - <function>sprintf</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fscanf</function></member> + <member><function>printf</function></member> + <member><function>sprintf</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/strtok.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/strings/functions/strtok.xml diff -u phpdoc-de/reference/strings/functions/strtok.xml:1.6 phpdoc-de/reference/strings/functions/strtok.xml:1.7 --- phpdoc-de/reference/strings/functions/strtok.xml:1.6 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/strtok.xml Tue Jul 1 15:12:15 2008 @@ -1,33 +1,85 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.7 Maintainer: sammywg Status: working --> - <refentry xml:id="function.strtok" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strtok</refname> - <refpurpose>Zerlegt einen String</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>strtok</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - <methodparam><type>string</type><parameter>token</parameter></methodparam> - </methodsynopsis> - <para> - <function>strtok</function> zerlegt einen String (<parameter>str</parameter>) - in kürzere Strings (Tokens), wobei jeder Token von im Parameter - <parameter>token</parameter> festgelegten Zeichen begrenzt wird. - Das bedeutet, dass, wenn Sie einen String wie "Dies ist ein Beispiel-String" - haben, Sie ihn in seine einzelnen Worte zerlegen können, wenn Sie das - Leerzeichen als Token verwenden. - <example> - <title><function>strtok</function> Beispiel</title> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.8 Maintainer: sammywg Status: ready --> + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strtok" xmlns:xlink="http://www.w3.org/1999/xlink"> + <refnamediv> + <refname>strtok</refname> + <refpurpose>Zerlegt einen String</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>strtok</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + <methodparam><type>string</type><parameter>token</parameter></methodparam> + </methodsynopsis> + <para> + <function>strtok</function> zerlegt einen String (<parameter>str</parameter>) + in kürzere Strings (Tokens), wobei jeder Token von im Parameter + <parameter>token</parameter> festgelegten Zeichen begrenzt wird. + Das bedeutet, dass, wenn Sie eine Zeichenkette wie "Dies ist ein + Beispiel-String" haben, Sie ihn in seine einzelnen Worte zerlegen können, + wenn Sie das Leerzeichen als Token verwenden. + </para> + <para> + Beachten Sie, dass nur der erste Aufruf von strtok das String-Argument + verwendet. Jeder Folgeaufruf von strtok benötigt nur den zu + beachtenden Token, um herauszufinden, wo sich diese im aktuellen String + befinden. Um neu zu beginnen oder einen neuen String zu zerlegen, + müssen Sie nur erneut strtok mit dem string-Parameter aufrufen, + damit die Funktion neu initialisiert wird. Beachten Sie, dass Sie + mehrere Token im Token-Parameter angeben können. Der String wird + dann an jeder Stelle zerlegt, an der eines der angegebenen Zeichen + gefunden wird. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + Der <type>String</type>, der in kleinere Zeichenketten (Token) zerlegt + werden soll. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>token</parameter></term> + <listitem> + <para> + Die Trennzeichen, die auf <parameter>str</parameter> angewendet werden + sollen. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Der aktuelle <type>String</type>-Token. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>strtok</function>-Beispiel</title> <programlisting role="php"> <![CDATA[ <?php $string = "Dies ist\tein Beispiel-\nString"; -/* Sowohl das Tabulator- als auch das Newline-Zeichen werden - zusätzlich zum Leerzeichen als Token zum Zerlegen verwendet */ +/* Sowohl das Tabulator- als auch das Newline-Zeichen werden + zusätzlich zum Leerzeichen als Token zum Zerlegen verwendet */ $tok = strtok($string, " \n\t"); while ($tok !== false) { @@ -36,28 +88,18 @@ } ?> ]]> - </programlisting> - </example> - </para> - <para> - Beachten Sie, dass nur der erste Aufruf von strtok das String-Argument - verwendet. Jeder Folgeaufruf von strtok benötigt nur die zu - beachtenden Token, um die für den aktuellen String notwendigen - herauszufinden. Um neu zu beginnen oder einen neuen String zu zerlegen, - müssen Sie nur erneut strtok mit dem string-Parameter aufrufen, - damit die Funktion neu initialisiert wird. Beachten Sie, dass Sie - mehrere Tokens im Token-Parameter angeben können. Der String wird - dann an jeder Stelle zerlegt, an der eines der angegebenen Zeichen - gefunden wird. - </para> - <para> - Das Verhalten der Funktion beim Auffinden eines leeren Teils veränderte - sich mit PHP Version 4.1.0. Zuvor wurde ein leerer String zurückgegeben, - wohingegen das neue, korrekte Verhalten diesen Teil des Strings verwirft. - </para> - <example> - <title>Altes Verhalten von <function>strtok</function></title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + Das Verhalten der Funktion beim Auffinden eines leeren Teils wurde in PHP + 4.1.0 verändert. Zuvor wurde ein leerer String zurückgegeben, wohingegen das + neue, korrekte Verhalten diesen Teil des Strings verwirft. + </para> + <para> + <example> + <title>Altes Verhalten von <function>strtok</function></title> + <programlisting role="php"> <![CDATA[ <?php $erster_token = strtok('/irgendetwas', '/'); @@ -65,20 +107,18 @@ var_dump($erster_token, $zweiter_token); ?> ]]> - </programlisting> - <para> - Ausgabe: - </para> - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ string(0) "" string(11) "irgendetwas" ]]> - </screen> - </example> - <example> - <title>Neues Verhalten von <function>strtok</function></title> - <programlisting role="php"> + </screen> + </example> + <example> + <title>Neues Verhalten von <function>strtok</function></title> + <programlisting role="php"> <![CDATA[ <?php $erster_token = strtok('/irgendetwas', '/'); @@ -86,26 +126,37 @@ var_dump($erster_token, $zweiter_token); ?> ]]> - </programlisting> - <para> - Ausgabe: - </para> - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ string(11) "irgendetwas" bool(false) ]]> - </screen> - </example> - &return.falseproblem; - <para> - Siehe auch <function>split</function> und - <function>explode</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + + &return.falseproblem; + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>split</function></member> + <member><function>explode</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + - <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/strtr.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/strings/functions/strtr.xml diff -u phpdoc-de/reference/strings/functions/strtr.xml:1.5 phpdoc-de/reference/strings/functions/strtr.xml:1.6 --- phpdoc-de/reference/strings/functions/strtr.xml:1.5 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/strtr.xml Tue Jul 1 15:12:15 2008 @@ -1,86 +1,170 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.6 Maintainer: sammywg Status: working --> - <refentry xml:id="function.strtr" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strtr</refname> - <refpurpose>Tauscht bestimmte Zeichen aus</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>strtr</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - <methodparam><type>string</type><parameter>from</parameter></methodparam> - <methodparam><type>string</type><parameter>to</parameter></methodparam> - </methodsynopsis> - <methodsynopsis> - <type>string</type><methodname>strtr</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - <methodparam><type>array</type><parameter>replace_pairs</parameter></methodparam> - </methodsynopsis> - <para> - Diese Funktion gibt eine Kopie von <parameter>str</parameter> zurück, - in der alle Vorkommen jedes Zeichens von <parameter>from</parameter> - in das korrespondierende Zeichen in <parameter>to</parameter> umgewandelt - wurde. - </para> - <para> - Haben <parameter>from</parameter> und <parameter>to</parameter> eine - unterschiedliche Länge, werden die überzähligen Zeichen im jeweils - längeren Parameter ignoriert. - <example> - <title><function>strtr</function> Beispiel</title> - <programlisting role="php"> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.7 Maintainer: sammywg Status: ready --> + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strtr" xmlns:xlink="http://www.w3.org/1999/xlink"> + <refnamediv> + <refname>strtr</refname> + <refpurpose>Tauscht bestimmte Zeichen aus</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>strtr</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + <methodparam><type>string</type><parameter>from</parameter></methodparam> + <methodparam><type>string</type><parameter>to</parameter></methodparam> + </methodsynopsis> + <methodsynopsis> + <type>string</type><methodname>strtr</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + <methodparam><type>array</type><parameter>replace_pairs</parameter></methodparam> + </methodsynopsis> + <para> + Diese Funktion gibt eine Kopie von <parameter>str</parameter> zurück, in der + alle Vorkommen jedes Zeichens von <parameter>from</parameter> in das + korrespondierende Zeichen in <parameter>to</parameter> umgewandelt wurden. + </para> + <para> + Haben <parameter>from</parameter> und <parameter>to</parameter> eine + unterschiedliche Länge, werden die überzähligen Zeichen im jeweils + längeren Parameter ignoriert. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + Der <type>String</type>, in dem die Ersetzungen vorgenommen werden sollen. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>from</parameter></term> + <listitem> + <para> + Der <type>String</type>, der gegen <parameter>to</parameter> ausgetauscht + werden soll. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>to</parameter></term> + <listitem> + <para> + Der <type>String</type>, der <parameter>from</parameter> ersetzen soll. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>replace_pairs</parameter></term> + <listitem> + <para> + Der <parameter>replace_pairs</parameter>-Parameter kann als Alternative + für die Parameter <parameter>to</parameter> und + <parameter>from</parameter> verwendet werden. In diesem Fall muss ein + <type>array</type> in der Form <literal>array('von' => 'nach', + ...)</literal> übergeben werden. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Die Funktion gibt eine Kopie von <parameter>str</parameter> zurück, in der + alle Vorkommen eines Zeichens in <parameter>from</parameter> gegen ihr + entsprechendes Pendant in <parameter>to</parameter> ausgetauscht wurden. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.0.0</entry> + <entry> + Die optionalen Parameter <parameter>to</parameter> und + <parameter>from</parameter> wurden eingeführt. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>strtr</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php -$addr = strtr($addr, "äåö", "aao"); +$addr = strtr($addr, "äåö", "aao"); ?> ]]> - </programlisting> - </example> - </para> - <para> - <function>strtr</function> kann auch mit nur zwei Argumenten - aufgerufen werden. Wenn der Aufruf mit zwei Argumenten durchgeführt - wird, verhält sich die Funktion anders: <parameter>from</parameter> - muss nun ein Array sein, das string->string-Paare enthält, die - im Originalstring ersetzt werden sollen. <function>strtr</function> - tauscht dabei zuerst die längsten möglichen Treffer aus und verändert - bereits durchgeführte Ersetzungen *NICHT*. - </para> - <example> - <title><function>strtr</function> Beispiel mit zwei Argumenten</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + <function>strtr</function> kann auch mit nur zwei Argumenten + aufgerufen werden. Wenn der Aufruf mit zwei Argumenten durchgeführt + wird, verhält sich die Funktion anders: <parameter>from</parameter> + muss nun ein Array sein, das string -> string-Paare enthält, die + im Originalstring ersetzt werden sollen. <function>strtr</function> + tauscht dabei zuerst die längsten möglichen Treffer aus und verändert + bereits durchgeführte Ersetzungen *NICHT*. + </para> + <example> + <title><function>strtr</function>-Beispiel mit zwei Argumenten</title> + <programlisting role="php"> <![CDATA[ <?php $trans = array("hallo" => "hi", "hi" => "hallo"); echo strtr("hi ihr, ich sagte hallo", $trans); ?> ]]> - </programlisting> - <para> - hat folgende Ausgabe: - </para> - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ hallo ihr, ich sagte hi ]]> - </screen> - </example> - <note> - <simpara> - Die optionalen Parameter <parameter>to</parameter> und - <parameter>from</parameter> wurden in PHP 4.0.0 eingeführt. - </simpara> - </note> - <para> - Siehe auch <function>ereg_replace</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>ereg_replace</function></member> + </simplelist> + </para> + </refsect1> +</refentry> + - <!-- Keep this comment at the end of the file Local variables: mode: sgml
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/errorfunc/functions/debug-backtrace.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/errorfunc/functions/debug-backtrace.xml diff -u phpdoc-de/reference/errorfunc/functions/debug-backtrace.xml:1.6 phpdoc-de/reference/errorfunc/functions/debug-backtrace.xml:1.7 --- phpdoc-de/reference/errorfunc/functions/debug-backtrace.xml:1.6 Fri May 2 15:07:47 2008 +++ phpdoc-de/reference/errorfunc/functions/debug-backtrace.xml Tue Jul 1 15:12:15 2008 @@ -1,107 +1,107 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.18 Maintainer: fa Status: ready --> - <refentry xml:id="function.debug-backtrace" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>debug_backtrace</refname> - <refpurpose>Erzeugt Daten zur Ablaufverfolgung</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>debug_backtrace</methodname> - <void/> - </methodsynopsis> - <para> - <function>debug_backtrace</function> erzeugt Daten zur Ablaufverfolgung. - </para> - </refsect1> - - <refsect1 role="returnvalues"> - &reftitle.returnvalues; - <para> - Gibt ein assoziatives <type>Array</type> zurück. Als - zurückgegebene Arrayelemente von <function>debug_backtrace</function> - sind möglich: - </para> - <para> - <table> - <title>Mögliche Rückgabewerte von <function>debug_backtrace</function></title> - <tgroup cols="3"> - <thead> - <row> - <entry>Name</entry> - <entry>Typ</entry> - <entry>Beschreibung</entry> - </row> - </thead> - <tbody> - <row> - <entry>function</entry> - <entry><type>string</type></entry> - <entry> - Der Name der aktuell ausgeführten Funktion. Siehe auch - <link linkend="language.constants.predefined">__FUNCTION__</link>. - </entry> - </row> - <row> - <entry>line</entry> - <entry><type>integer</type></entry> - <entry> - Die aktuelle Zeilennummer. Siehe auch - <link linkend="language.constants.predefined">__LINE__</link>. - </entry> - </row> - <row> - <entry>file</entry> - <entry><type>string</type></entry> - <entry> - Der aktuelle Dateiname. Siehe auch - <link linkend="language.constants.predefined">__FILE__</link>. - </entry> - </row> - <row> - <entry>class</entry> - <entry><type>string</type></entry> - <entry> - Der aktuelle <link linkend="language.oop">class</link> - Name. Siehe auch - <link linkend="language.constants.predefined">__CLASS__</link>. - </entry> - </row> - <row> - <entry>object</entry> - <entry><type>object</type></entry> - <entry> - Das aktuelle <link linkend="language.oop">Objekt</link>. Dieses - Element ist seit PHP 5.1.1 verfügbar. - </entry> - </row> - <row> - <entry>type</entry> - <entry><type>string</type></entry> - <entry> - Der aktuelle Typ des Aufrufs. Falls der Aufruf in einer - Methode erfolgte, wird "->" zurückgegeben. Falls der Aufruf - aus einer statischen Funktion erfolgte, wird "::" - zurückgegeben und falls der Aufruf aus einer Funktion - erfolgte, wird nichts zurückgegeben. - </entry> - </row> - <row> - <entry>args</entry> - <entry><type>array</type></entry> - <entry> - Falls der Aufruf aus einer Funktion erfolgte, werden hier die - Funktionsargumente aufgelistet. Falls der Aufruf aus einer - eingebundenen Datei erfolgte, werden die Namen der - Include-Dateien angegeben. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.19 Maintainer: fa Status: ready --> + +<refentry xml:id="function.debug-backtrace" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>debug_backtrace</refname> + <refpurpose>Erzeugt Daten zur Ablaufverfolgung</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>debug_backtrace</methodname> + <methodparam choice="opt"><type>bool</type><parameter>provide_object</parameter></methodparam> + </methodsynopsis> + <para> + <function>debug_backtrace</function> erzeugt Daten zur Ablaufverfolgung. + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt ein assoziatives <type>Array</type> zurück. Als zurückgegebene + Arrayelemente von <function>debug_backtrace</function> sind möglich: + </para> + <para> + <table> + <title>Mögliche Rückgabewerte von <function>debug_backtrace</function></title> + <tgroup cols="3"> + <thead> + <row> + <entry>&Name;</entry> + <entry>&Type;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>function</entry> + <entry><type>string</type></entry> + <entry> + Der Name der aktuell ausgeführten Funktion. Siehe auch + <link linkend="language.constants.predefined">__FUNCTION__</link>. + </entry> + </row> + <row> + <entry>line</entry> + <entry><type>integer</type></entry> + <entry> + Die aktuelle Zeilennummer. Siehe auch + <link linkend="language.constants.predefined">__LINE__</link>. + </entry> + </row> + <row> + <entry>file</entry> + <entry><type>string</type></entry> + <entry> + Der aktuelle Dateiname. Siehe auch + <link linkend="language.constants.predefined">__FILE__</link>. + </entry> + </row> + <row> + <entry>class</entry> + <entry><type>string</type></entry> + <entry> + Der aktuelle <link linkend="language.oop">class</link> - Name. Siehe auch + <link linkend="language.constants.predefined">__CLASS__</link>. + </entry> + </row> + <row> + <entry>object</entry> + <entry><type>object</type></entry> + <entry> + Das aktuelle <link linkend="language.oop">Objekt</link>. + </entry> + </row> + <row> + <entry>type</entry> + <entry><type>string</type></entry> + <entry> + Der aktuelle Typ des Aufrufs. Falls der Aufruf in einer + Methode erfolgte, wird "->" zurückgegeben. Falls der Aufruf + aus einer statischen Funktion erfolgte, wird "::" + zurückgegeben und falls der Aufruf aus einer Funktion + erfolgte, wird nichts zurückgegeben. + </entry> + </row> + <row> + <entry>args</entry> + <entry><type>array</type></entry> + <entry> + Falls der Aufruf aus einer Funktion erfolgte, werden hier die + Funktionsargumente aufgelistet. Falls der Aufruf aus einer + eingebundenen Datei erfolgte, werden die Namen der + Include-Dateien angegeben. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> <refsect1 role="changelog"> &reftitle.changelog; @@ -116,9 +116,16 @@ </thead> <tbody> <row> + <entry>5.2.5</entry> + <entry> + Der optionale Parameter <parameter>provide_object</parameter> wurde + hinzugefügt. + </entry> + </row> + <row> <entry>5.1.1</entry> <entry> - Aktuelles <type>object</type> als möglichen Rückgabewert hinzugefügt. + Aktuelles <type>object</type> als möglichen Rückgabewert hinzugefügt. </entry> </row> </tbody> @@ -127,17 +134,17 @@ </para> </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - <example> - <title><function>debug_backtrace</function>-Beispiel</title> - <programlisting role="php"> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>debug_backtrace</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php -// Dateiname: /tmp/a.php +// Dateiname: a.php -function a_test($str) +function a_test($str) { echo "\nHi: $str"; var_dump(debug_backtrace()); @@ -151,11 +158,11 @@ include_once '/tmp/a.php'; ?> ]]> - </programlisting> - <para> - Ergebnisse beim Aufruf von <filename>/tmp/b.php</filename>: - </para> - <screen> + </programlisting> + <para> + Ergebnisse beim Aufruf von <filename>/tmp/b.php</filename>: + </para> + <screen> <![CDATA[ Hi: friend array(2) { @@ -173,7 +180,7 @@ array(4) { ["file"] => string(10) "/tmp/b.php" ["line"] => int(2) - ["args"] => + ["args"] => array(1) { [0] => string(10) "/tmp/a.php" } @@ -181,21 +188,22 @@ } } ]]> - </screen> - </example> - </para> - </refsect1> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>trigger_error</function></member> + <member><function>debug_print_backtrace</function></member> + </simplelist> + </para> + </refsect1> +</refentry> - <refsect1 role="seealso"> - &reftitle.seealso; - <para> - <simplelist> - <member><function>trigger_error</function></member> - <member><function>debug_print_backtrace</function></member> - </simplelist> - </para> - </refsect1> - </refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/number-format.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-de/reference/strings/functions/number-format.xml diff -u phpdoc-de/reference/strings/functions/number-format.xml:1.2 phpdoc-de/reference/strings/functions/number-format.xml:1.3 --- phpdoc-de/reference/strings/functions/number-format.xml:1.2 Sat Jun 23 13:21:49 2007 +++ phpdoc-de/reference/strings/functions/number-format.xml Tue Jul 1 15:12:15 2008 @@ -1,61 +1,118 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.10 Maintainer: sammywg Status: ready --> - <refentry xml:id="function.number-format" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>number_format</refname> - <refpurpose>Formatiert eine Zahl mit Tausender-Gruppierung</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>number_format</methodname> - <methodparam><type>float</type><parameter>number</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>decimals</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>dec_point</parameter></methodparam> - <methodparam><type>string</type><parameter>thousands_sep</parameter></methodparam> - </methodsynopsis> - <para> - <function>number_format</function> gibt eine formatierte Version von - <parameter>number</parameter> zurück. Die Funktion akzeptiert entweder - einen, zwei oder vier Parameter (nicht jedoch drei): - </para> - <para> - Wird nur ein Parameter übergeben, wird <parameter>number</parameter> - ohne Dezimalstellen, aber mit einem Komma (",") zur Gruppierung der - Tausenderstellen formatiert. - </para> - <para> - Wurden zwei Parameter übergeben, wird <parameter>number</parameter> als - Zahl mit <parameter>decimals</parameter> Dezimalstellen mit einem Punkt - (".") als Trennzeichen sowie einem Komma (",") zur Gruppierung der - Tausenderstellen formatiert. - </para> - <para> - Wenn alle vier Parameter übergeben wurden, wird <parameter>number</parameter> - als Zahl formatiert, die <parameter>decimals</parameter> Dezimalstellen hat, - die mittels <parameter>dec_point</parameter> anstelle des Punktes (".") - von der Zahl getrennt werden, und deren Tausenderstellen mittels - <parameter>thousands_sep</parameter> anstelle des Kommas (",") gruppiert - werden. - </para> - <para> - Nur das erste Zeichen von <parameter>thousands_sep</parameter> wird - verwendet. Wenn Sie beispielsweise <literal>bar</literal> für - <parameter>thousands_sep</parameter> auf die Zahl <literal>1000</literal> - anwenden, gibt Ihnen <function>number_format</function> - <literal>1b000</literal> zurück. - </para> - <para> - <example> - <title><function>number_format</function>-Beispiel</title> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.13 Maintainer: sammywg Status: ready --> + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.number-format" xmlns:xlink="http://www.w3.org/1999/xlink"> + <refnamediv> + <refname>number_format</refname> + <refpurpose>Formatiert eine Zahl mit Tausender-Gruppierung</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>number_format</methodname> + <methodparam><type>float</type><parameter>number</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>decimals</parameter></methodparam> + </methodsynopsis> + <methodsynopsis> + <type>string</type><methodname>number_format</methodname> + <methodparam><type>float</type><parameter>number</parameter></methodparam> + <methodparam><type>int</type><parameter>decimals</parameter></methodparam> + <methodparam><type>string</type><parameter>dec_point</parameter></methodparam> + <methodparam><type>string</type><parameter>thousands_sep</parameter></methodparam> + </methodsynopsis> + <para> + Die Funktion akzeptiert entweder einen, zwei oder vier Parameter + (nicht jedoch drei): + </para> + <para> + Wird nur ein Parameter übergeben, wird <parameter>number</parameter> + ohne Nachkommastellen, aber mit einem Komma (",") zur Gruppierung der + Tausenderstellen formatiert. + </para> + <para> + Wurden zwei Parameter übergeben, wird <parameter>number</parameter> als + Zahl mit <parameter>decimals</parameter> Nachkommastellen mit einem Punkt + (".") als Trennzeichen sowie einem Komma (",") zur Gruppierung der + Tausenderstellen formatiert. + </para> + <para> + Wenn alle vier Parameter übergeben wurden, wird <parameter>number</parameter> + als Zahl formatiert, die <parameter>decimals</parameter> Nachkommastellen + hat, die mittels <parameter>dec_point</parameter> anstelle des Punktes (".") + von der Zahl getrennt werden, und deren Tausenderstellen mittels + <parameter>thousands_sep</parameter> anstelle des Kommas (",") gruppiert + werden. + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Eine formatierte Version von <parameter>number</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>number</parameter></term> + <listitem> + <para> + Die zu formatierende Zahl. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>decimals</parameter></term> + <listitem> <para> - Beispielsweise notiert man in Frankreich normalerweise zwei - Dezimalstellen mit einem Komma (',') als Trennzeichen sowie ein - Leerzeichen (' ') zur Gruppierung der Tausender. Das kann durch folgende - Zeile erreicht werden: + Sets the number of decimal points. </para> - <programlisting role="php"> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dec_point</parameter></term> + <listitem> + <para> + Bestimmt das Trennzeichen für die Nachkommastellen. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>thousands_sep</parameter></term> + <listitem> + <para> + Bestimmt das Tausendertrennzeichen. + </para> + <para> + Nur das erste Zeichen von <parameter>thousands_sep</parameter> wird + verwendet. Wenn Sie beispielsweise <literal>bar</literal> für + <parameter>thousands_sep</parameter> auf die Zahl <literal>1000</literal> + anwenden, gibt Ihnen <function>number_format</function> + <literal>1b000</literal> zurück. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>number_format</function>-Beispiel</title> + <para> + Beispielsweise notiert man in Frankreich normalerweise zwei + Dezimalstellen mit einem Komma (',') als Trennzeichen sowie ein + Leerzeichen (' ') zur Gruppierung der Tausender. Das kann durch folgende + Zeile erreicht werden: + </para> + <programlisting role="php"> <![CDATA[ <?php @@ -77,18 +134,25 @@ ?> ]]> - </programlisting> - </example> - </para> - <para> - Siehe auch - <function>money_format</function>, - <function>sprintf</function>, - <function>printf</function> und - <function>sscanf</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>money_format</function></member> + <member><function>sprintf</function></member> + <member><function>printf</function></member> + <member><function>sscanf</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/parse-str.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/strings/functions/parse-str.xml diff -u phpdoc-de/reference/strings/functions/parse-str.xml:1.8 phpdoc-de/reference/strings/functions/parse-str.xml:1.9 --- phpdoc-de/reference/strings/functions/parse-str.xml:1.8 Thu Oct 25 18:52:23 2007 +++ phpdoc-de/reference/strings/functions/parse-str.xml Tue Jul 1 15:12:15 2008 @@ -1,10 +1,11 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.14 Maintainer: sammywg Status: ready --> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.15 Maintainer: sammywg Status: ready --> + <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.parse-str"> <refnamediv> <refname>parse_str</refname> - <refpurpose>Überträgt einen String in Variable</refpurpose> + <refpurpose>Ãberträgt einen String in Variable</refpurpose> </refnamediv> <refsect1 role="description"> @@ -16,7 +17,7 @@ </methodsynopsis> <para> Verarbeitet <parameter>str</parameter>, als ob er der Query-String - einer URL-Übergabe via GET wäre, und erstellt Variablen im aktuellen + einer URL-Ãbergabe via GET wäre, und erstellt Variablen im aktuellen Geltungsbereich. </para> <note> @@ -25,14 +26,14 @@ verwenden Sie am besten die Variable <link linkend="reserved.variables.server">$_SERVER['QUERY_STRING']</link>. Weitere Informationen finden Sie auch im Abschnitt <link - linkend="language.variables.external">Variablen außerhalb von PHP</link>. + linkend="language.variables.external">Variablen aus externen Quellen</link>. </para> </note> <note> <para> Die <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link>-Einstellungen beeinflussen die Ausgabe der Funktion, da <function>parse_str</function> - dieselben Mechanismen verwendet, die PHP zum Füllen von + dieselben Mechanismen verwendet, die PHP zum Füllen von <literal>$_GET</literal>, <literal>$_POST</literal> und anderen Variablen nutzt. </para> @@ -87,7 +88,7 @@ <row> <entry>4.0.3</entry> <entry> - Der Parameter <parameter>arr</parameter> wurde hinzugefügt. + Der Parameter <parameter>arr</parameter> wurde hinzugefügt. </entry> </row> </tbody> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/sscanf.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-de/reference/strings/functions/sscanf.xml diff -u phpdoc-de/reference/strings/functions/sscanf.xml:1.7 phpdoc-de/reference/strings/functions/sscanf.xml:1.8 --- phpdoc-de/reference/strings/functions/sscanf.xml:1.7 Wed Oct 24 22:20:05 2007 +++ phpdoc-de/reference/strings/functions/sscanf.xml Tue Jul 1 15:12:15 2008 @@ -1,82 +1,136 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.16 Maintainer: sammywg Status: ready --> - <refentry xml:id="function.sscanf" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>sscanf</refname> - <refpurpose> - Überträgt einen String in ein angegebenes Format - </refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>mixed</type><methodname>sscanf</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - <methodparam><type>string</type><parameter>format</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter role="reference">...</parameter></methodparam> - </methodsynopsis> - <para> - Die Funktion <function>sscanf</function> ist die Eingabe analog zu - <function>printf</function>. <function>sscanf</function> liest den String - <parameter>str</parameter> und interpretiert ihn entsprechend dem - angegebenen Parameter <parameter>format</parameter>, der in der - Dokumentation zu <function>sprintf</function> näher beschrieben ist. Werden - nur 2 Parameter an die Funktion übergeben, werden die analysierten Werte - als Array zurückgegeben. Andernfalls, wenn optionale Parameter beachtet - wurden, gibt die Funktion die Anzahl der ermittelten Werte zurück. Die - optionalen Parameter müssen referenziert übergeben werden. - </para> - <para> - Beliebige Whitespaces im Formatstring entsprechen beliebigen Whitespaces im - Inputstring. Das heißt, dass auch ein Tabulator \t im Formatstring einem - einzelnen Leerzeichen des Inputstrings entsprechen kann. - </para> - <para> - <example> - <title><function>sscanf</function>-Beispiel:</title> - <programlisting role="php"> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.17 Maintainer: sammywg Status: ready --> + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.sscanf" xmlns:xlink="http://www.w3.org/1999/xlink"> + <refnamediv> + <refname>sscanf</refname> + <refpurpose>Ãberträgt einen String in ein angegebenes Format</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>sscanf</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + <methodparam><type>string</type><parameter>format</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter role="reference">...</parameter></methodparam> + </methodsynopsis> + <para> + Die Funktion <function>sscanf</function> ist das Eingabegegenstück zu + <function>printf</function>. <function>sscanf</function> liest den String + <parameter>str</parameter> und interpretiert ihn entsprechend dem + übergegebenen <parameter>format</parameter>-Parameter , der in der + Dokumentation zu <function>sprintf</function> näher beschrieben ist. + </para> + <para> + Beliebige Whitespaces im Formatstring entsprechen beliebigen Whitespaces im + Inputstring. Das heiÃt, dass auch ein Tabulator \t im Formatstring einem + einzelnen Leerzeichen des Inputstrings entsprechen kann. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + Der zu parsende Eingabe<type>string</type>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>format</parameter></term> + <listitem> + <para> + Das interpretierte Format für <parameter>str</parameter>, wie es in der + Dokumentation zu <function>sprintf</function> beschrieben ist. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>...</parameter></term> + <listitem> + <para> + Optionale als Referenz übergebene Variablen, die die geparsten Werte + enthalten. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Werden nur 2 Parameter an die Funktion übergeben, werden die analysierten + Werte als Array zurückgegeben. Andernfalls, wenn optionale Parameter + übergeben wurden, gibt die Funktion die Anzahl der ermittelten Werte zurück. + Die optionalen Parameter müssen als Referenz übergeben werden. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>sscanf</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php // Ermittlung der Serien-Nr. -$serial = sscanf("SN/2350001","SN/%d"); +list($serial) = sscanf("SN/2350001", "SN/%d"); // und des Herstellungsdatums $mandate = "Januar 01 2000"; -list($monat, $tag, $jahr) = sscanf($mandate,"%s %d %d"); +list($monat, $tag, $jahr) = sscanf($mandate, "%s %d %d"); echo "Das Teil $serial wurde hergestellt am: " . "$jahr-" . substr($monat, 0, 3) . "-$tag\n"; ?> ]]> - </programlisting> - </example> - Werden optionale Parameter übergeben, gibt die Funktion die Anzahl - der ermittelten Werte zurück. - <example> - <title> - <function>sscanf</function> - Gebrauch optionaler Parameter</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + Werden optionale Parameter übergeben, gibt die Funktion die Anzahl + der ermittelten Werte zurück. + </para> + <para> + <example> + <title><function>sscanf</function> - Verwendung optionaler Parameter</title> + <programlisting role="php"> <![CDATA[ <?php -// Ermittlung der Autoren-Info und Erzeugung eines DocBook-Eintrages +// Auslesen der Autoren-Info und Erzeugung eines DocBook-Eintrages $auth = "24\tLewis Carroll"; -$n = sscanf($auth,"%d\t%s %s", &$id, &$first, &$last); +$n = sscanf($auth, "%d\t%s %s", $id, $first, $last); echo "<author id='$id'> <firstname>$first</firstname> <surname>$last</surname> </author>\n"; ?> ]]> - </programlisting> - </example> - </para> - <para> - Siehe auch - <function>fscanf</function>, - <function>printf</function> und - <function>sprintf</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fscanf</function></member> + <member><function>printf</function></member> + <member><function>sprintf</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/strtok.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/strings/functions/strtok.xml diff -u phpdoc-de/reference/strings/functions/strtok.xml:1.6 phpdoc-de/reference/strings/functions/strtok.xml:1.7 --- phpdoc-de/reference/strings/functions/strtok.xml:1.6 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/strtok.xml Tue Jul 1 15:12:15 2008 @@ -1,33 +1,85 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.7 Maintainer: sammywg Status: working --> - <refentry xml:id="function.strtok" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strtok</refname> - <refpurpose>Zerlegt einen String</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>strtok</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - <methodparam><type>string</type><parameter>token</parameter></methodparam> - </methodsynopsis> - <para> - <function>strtok</function> zerlegt einen String (<parameter>str</parameter>) - in kürzere Strings (Tokens), wobei jeder Token von im Parameter - <parameter>token</parameter> festgelegten Zeichen begrenzt wird. - Das bedeutet, dass, wenn Sie einen String wie "Dies ist ein Beispiel-String" - haben, Sie ihn in seine einzelnen Worte zerlegen können, wenn Sie das - Leerzeichen als Token verwenden. - <example> - <title><function>strtok</function> Beispiel</title> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.8 Maintainer: sammywg Status: ready --> + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strtok" xmlns:xlink="http://www.w3.org/1999/xlink"> + <refnamediv> + <refname>strtok</refname> + <refpurpose>Zerlegt einen String</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>strtok</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + <methodparam><type>string</type><parameter>token</parameter></methodparam> + </methodsynopsis> + <para> + <function>strtok</function> zerlegt einen String (<parameter>str</parameter>) + in kürzere Strings (Tokens), wobei jeder Token von im Parameter + <parameter>token</parameter> festgelegten Zeichen begrenzt wird. + Das bedeutet, dass, wenn Sie eine Zeichenkette wie "Dies ist ein + Beispiel-String" haben, Sie ihn in seine einzelnen Worte zerlegen können, + wenn Sie das Leerzeichen als Token verwenden. + </para> + <para> + Beachten Sie, dass nur der erste Aufruf von strtok das String-Argument + verwendet. Jeder Folgeaufruf von strtok benötigt nur den zu + beachtenden Token, um herauszufinden, wo sich diese im aktuellen String + befinden. Um neu zu beginnen oder einen neuen String zu zerlegen, + müssen Sie nur erneut strtok mit dem string-Parameter aufrufen, + damit die Funktion neu initialisiert wird. Beachten Sie, dass Sie + mehrere Token im Token-Parameter angeben können. Der String wird + dann an jeder Stelle zerlegt, an der eines der angegebenen Zeichen + gefunden wird. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + Der <type>String</type>, der in kleinere Zeichenketten (Token) zerlegt + werden soll. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>token</parameter></term> + <listitem> + <para> + Die Trennzeichen, die auf <parameter>str</parameter> angewendet werden + sollen. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Der aktuelle <type>String</type>-Token. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>strtok</function>-Beispiel</title> <programlisting role="php"> <![CDATA[ <?php $string = "Dies ist\tein Beispiel-\nString"; -/* Sowohl das Tabulator- als auch das Newline-Zeichen werden - zusätzlich zum Leerzeichen als Token zum Zerlegen verwendet */ +/* Sowohl das Tabulator- als auch das Newline-Zeichen werden + zusätzlich zum Leerzeichen als Token zum Zerlegen verwendet */ $tok = strtok($string, " \n\t"); while ($tok !== false) { @@ -36,28 +88,18 @@ } ?> ]]> - </programlisting> - </example> - </para> - <para> - Beachten Sie, dass nur der erste Aufruf von strtok das String-Argument - verwendet. Jeder Folgeaufruf von strtok benötigt nur die zu - beachtenden Token, um die für den aktuellen String notwendigen - herauszufinden. Um neu zu beginnen oder einen neuen String zu zerlegen, - müssen Sie nur erneut strtok mit dem string-Parameter aufrufen, - damit die Funktion neu initialisiert wird. Beachten Sie, dass Sie - mehrere Tokens im Token-Parameter angeben können. Der String wird - dann an jeder Stelle zerlegt, an der eines der angegebenen Zeichen - gefunden wird. - </para> - <para> - Das Verhalten der Funktion beim Auffinden eines leeren Teils veränderte - sich mit PHP Version 4.1.0. Zuvor wurde ein leerer String zurückgegeben, - wohingegen das neue, korrekte Verhalten diesen Teil des Strings verwirft. - </para> - <example> - <title>Altes Verhalten von <function>strtok</function></title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + Das Verhalten der Funktion beim Auffinden eines leeren Teils wurde in PHP + 4.1.0 verändert. Zuvor wurde ein leerer String zurückgegeben, wohingegen das + neue, korrekte Verhalten diesen Teil des Strings verwirft. + </para> + <para> + <example> + <title>Altes Verhalten von <function>strtok</function></title> + <programlisting role="php"> <![CDATA[ <?php $erster_token = strtok('/irgendetwas', '/'); @@ -65,20 +107,18 @@ var_dump($erster_token, $zweiter_token); ?> ]]> - </programlisting> - <para> - Ausgabe: - </para> - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ string(0) "" string(11) "irgendetwas" ]]> - </screen> - </example> - <example> - <title>Neues Verhalten von <function>strtok</function></title> - <programlisting role="php"> + </screen> + </example> + <example> + <title>Neues Verhalten von <function>strtok</function></title> + <programlisting role="php"> <![CDATA[ <?php $erster_token = strtok('/irgendetwas', '/'); @@ -86,26 +126,37 @@ var_dump($erster_token, $zweiter_token); ?> ]]> - </programlisting> - <para> - Ausgabe: - </para> - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ string(11) "irgendetwas" bool(false) ]]> - </screen> - </example> - &return.falseproblem; - <para> - Siehe auch <function>split</function> und - <function>explode</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + + &return.falseproblem; + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>split</function></member> + <member><function>explode</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + - <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/strtr.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/strings/functions/strtr.xml diff -u phpdoc-de/reference/strings/functions/strtr.xml:1.5 phpdoc-de/reference/strings/functions/strtr.xml:1.6 --- phpdoc-de/reference/strings/functions/strtr.xml:1.5 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/strtr.xml Tue Jul 1 15:12:15 2008 @@ -1,86 +1,170 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.6 Maintainer: sammywg Status: working --> - <refentry xml:id="function.strtr" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strtr</refname> - <refpurpose>Tauscht bestimmte Zeichen aus</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>strtr</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - <methodparam><type>string</type><parameter>from</parameter></methodparam> - <methodparam><type>string</type><parameter>to</parameter></methodparam> - </methodsynopsis> - <methodsynopsis> - <type>string</type><methodname>strtr</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - <methodparam><type>array</type><parameter>replace_pairs</parameter></methodparam> - </methodsynopsis> - <para> - Diese Funktion gibt eine Kopie von <parameter>str</parameter> zurück, - in der alle Vorkommen jedes Zeichens von <parameter>from</parameter> - in das korrespondierende Zeichen in <parameter>to</parameter> umgewandelt - wurde. - </para> - <para> - Haben <parameter>from</parameter> und <parameter>to</parameter> eine - unterschiedliche Länge, werden die überzähligen Zeichen im jeweils - längeren Parameter ignoriert. - <example> - <title><function>strtr</function> Beispiel</title> - <programlisting role="php"> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.7 Maintainer: sammywg Status: ready --> + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strtr" xmlns:xlink="http://www.w3.org/1999/xlink"> + <refnamediv> + <refname>strtr</refname> + <refpurpose>Tauscht bestimmte Zeichen aus</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>strtr</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + <methodparam><type>string</type><parameter>from</parameter></methodparam> + <methodparam><type>string</type><parameter>to</parameter></methodparam> + </methodsynopsis> + <methodsynopsis> + <type>string</type><methodname>strtr</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + <methodparam><type>array</type><parameter>replace_pairs</parameter></methodparam> + </methodsynopsis> + <para> + Diese Funktion gibt eine Kopie von <parameter>str</parameter> zurück, in der + alle Vorkommen jedes Zeichens von <parameter>from</parameter> in das + korrespondierende Zeichen in <parameter>to</parameter> umgewandelt wurden. + </para> + <para> + Haben <parameter>from</parameter> und <parameter>to</parameter> eine + unterschiedliche Länge, werden die überzähligen Zeichen im jeweils + längeren Parameter ignoriert. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + Der <type>String</type>, in dem die Ersetzungen vorgenommen werden sollen. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>from</parameter></term> + <listitem> + <para> + Der <type>String</type>, der gegen <parameter>to</parameter> ausgetauscht + werden soll. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>to</parameter></term> + <listitem> + <para> + Der <type>String</type>, der <parameter>from</parameter> ersetzen soll. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>replace_pairs</parameter></term> + <listitem> + <para> + Der <parameter>replace_pairs</parameter>-Parameter kann als Alternative + für die Parameter <parameter>to</parameter> und + <parameter>from</parameter> verwendet werden. In diesem Fall muss ein + <type>array</type> in der Form <literal>array('von' => 'nach', + ...)</literal> übergeben werden. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Die Funktion gibt eine Kopie von <parameter>str</parameter> zurück, in der + alle Vorkommen eines Zeichens in <parameter>from</parameter> gegen ihr + entsprechendes Pendant in <parameter>to</parameter> ausgetauscht wurden. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.0.0</entry> + <entry> + Die optionalen Parameter <parameter>to</parameter> und + <parameter>from</parameter> wurden eingeführt. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>strtr</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php -$addr = strtr($addr, "äåö", "aao"); +$addr = strtr($addr, "äåö", "aao"); ?> ]]> - </programlisting> - </example> - </para> - <para> - <function>strtr</function> kann auch mit nur zwei Argumenten - aufgerufen werden. Wenn der Aufruf mit zwei Argumenten durchgeführt - wird, verhält sich die Funktion anders: <parameter>from</parameter> - muss nun ein Array sein, das string->string-Paare enthält, die - im Originalstring ersetzt werden sollen. <function>strtr</function> - tauscht dabei zuerst die längsten möglichen Treffer aus und verändert - bereits durchgeführte Ersetzungen *NICHT*. - </para> - <example> - <title><function>strtr</function> Beispiel mit zwei Argumenten</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + <function>strtr</function> kann auch mit nur zwei Argumenten + aufgerufen werden. Wenn der Aufruf mit zwei Argumenten durchgeführt + wird, verhält sich die Funktion anders: <parameter>from</parameter> + muss nun ein Array sein, das string -> string-Paare enthält, die + im Originalstring ersetzt werden sollen. <function>strtr</function> + tauscht dabei zuerst die längsten möglichen Treffer aus und verändert + bereits durchgeführte Ersetzungen *NICHT*. + </para> + <example> + <title><function>strtr</function>-Beispiel mit zwei Argumenten</title> + <programlisting role="php"> <![CDATA[ <?php $trans = array("hallo" => "hi", "hi" => "hallo"); echo strtr("hi ihr, ich sagte hallo", $trans); ?> ]]> - </programlisting> - <para> - hat folgende Ausgabe: - </para> - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ hallo ihr, ich sagte hi ]]> - </screen> - </example> - <note> - <simpara> - Die optionalen Parameter <parameter>to</parameter> und - <parameter>from</parameter> wurden in PHP 4.0.0 eingeführt. - </simpara> - </note> - <para> - Siehe auch <function>ereg_replace</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>ereg_replace</function></member> + </simplelist> + </para> + </refsect1> +</refentry> + - <!-- Keep this comment at the end of the file Local variables: mode: sgml