cvs: phpdoc-de /reference/strings/functions parse-str.xml print.xml printf.xml quotemeta.xml
| From: | Thomas Schoefbeck | Date: | Tue, 11 Feb 2003 19:03:44 +0000 |
| Subject: | cvs: phpdoc-de /reference/strings/functions parse-str.xml print.xml printf.xml quotemeta.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-511@lists.php.net to get a copy of this message | ||
tom Tue Feb 11 14:03:44 2003 EDT
Modified files:
/phpdoc-de/reference/strings/functions parse-str.xml print.xml
printf.xml quotemeta.xml
Log:
sync to en
Index: phpdoc-de/reference/strings/functions/parse-str.xml diff -u phpdoc-de/reference/strings/functions/parse-str.xml:1.4 phpdoc-de/reference/strings/functions/parse-str.xml:1.5 --- phpdoc-de/reference/strings/functions/parse-str.xml:1.4 Tue Aug 27 15:27:50 2002 +++ phpdoc-de/reference/strings/functions/parse-str.xml Tue Feb 11 14:03:44 2003 @@ -1,45 +1,66 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> -<!-- last change to 'parse-str' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.2 --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.parse-str"> <refnamediv> <refname>parse_str</refname> <refpurpose>Überträgt einen String in Variable</refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> <type>void</type><methodname>parse_str</methodname> <methodparam><type>string</type><parameter>str</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>arr</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>arr + </parameter></methodparam> </methodsynopsis> <para> Durchsucht <parameter>str</parameter> als ob er der Query-String - einer URL-Übergabe via GET wäre und gibt die Werte - Variableninhalte zurück. Ist der zweite Parameter - <parameter>arr</parameter> gegeben, werden die Variablen-Werte in - diesem Array als dessen Elemente gespeichert. + einer URL-Übergabe via GET wäre und erstellt Variablen im aktuellen + Geltungsbereich. Ist der zweite Parameter <parameter>arr</parameter> + angegeben, werden die Variablen in diesem Array als dessen Elemente + gespeichert. </para> <note> <para> Der optionale zweite Parameter wurde in PHP 4.0.3 hinzugefügt. </para> </note> - + <note> + <para> + Um auf den aktuellen <emphasis>QUERY_STRING</emphasis> zuzugreifen, + 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>. + </para> + </note> <para> <example> - <title>Der Gebrauch von <function>parse_str:</function></title> + <title>Der Gebrauch von <function>parse_str</function></title> <programlisting role="php"> -$str = "erster=nichts&zweiter[]=etwas&zweiter[]=nochwas"; +<![CDATA[ +<?php +$str = "first=value&arr[]=foo+bar&arr[]=baz"; parse_str($str); -echo $erster; /* gibt "nichts" aus */ -echo $zweiter[0]; /* gibt "etwas" aus */ -echo $zweiter[1]; /* gibt "nochwas" aus */ +echo $first; // value +echo $arr[0]; // foo bar +echo $arr[1]; // baz + +parse_str($str, $output); +echo $output['first']; // value +echo $output['arr'][0]; // foo bar +echo $output['arr'][1]; // baz + +?> +]]> </programlisting> </example> + </para> + <para> + Siehe auch <function>parse_url</function>, <function>pathinfo</function>, + <function>set_magic_quotes_runtime</function> und <function>urldecode</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/strings/functions/print.xml diff -u phpdoc-de/reference/strings/functions/print.xml:1.3 phpdoc-de/reference/strings/functions/print.xml:1.4 --- phpdoc-de/reference/strings/functions/print.xml:1.3 Sun Jun 9 06:56:16 2002 +++ phpdoc-de/reference/strings/functions/print.xml Tue Feb 11 14:03:44 2003 @@ -1,23 +1,67 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> -<!-- last change to 'print' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.2 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.print"> <refnamediv> <refname>print</refname> <refpurpose>Ausgabe eines Strings</refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> - <methodname>print</methodname> + <type>void</type><methodname>print</methodname> <methodparam><type>string</type><parameter>arg</parameter></methodparam> </methodsynopsis> <simpara> - Gibt <parameter>arg</parameter> aus. + Gibt <parameter>arg</parameter> aus. &return.success; </simpara> + <para> + <function>print</function> ist eigentlich keine wirkliche Funktion + (sie ist ein Sprachkonstukt), weshalb Sie beim Aufruf nicht unbedingt + Klammern benutzen müssen. + </para> + <example> + <title><function>print</function> Beispiele</title> + <programlisting role="php"> +<![CDATA[ +<?php +print("Hello World"); + +print "print() funktioniert auch ohne Klammern."; + +print "Dies umfasst +mehrere Zeilen. Die Zeilenumbrüche werden +ebenfalls ausgegeben"; + +print "Dies hat\nmehrere Zeilen. Die Umbrüche werden\nauch ausgegeben."; + +print "Escape-Zeichen werden \"so\" geschrieben."; + +// Sie können in einer print-Anweisung auch Variablen benutzen +$foo = "foobar"; +$bar = "barbaz"; + +print "foo is $foo"; // foo ist foobar + +// Einfache Anführungsstriche geben den Variablennamen aus, +// nicht den Inhalt +print 'foo is $foo'; // foo ist $foo + +// Benutzen Sie keine anderen Zeichen, können Sie auch nur +// Variablen ausgeben +print $foo; // foobar + +print <<<END +Dies verwendet die "here document" Syntax zur Ausgabe von +mehreren Zeilen mit $variablen Interpolation. Beachten Sie, +dass das "here document" Endezeichen in einer Zeile nur mit +einem Semikolon ohne Whitespaces stehen muss! +END; +?> +]]> + </programlisting> + </example> <simpara> Siehe auch <function>echo</function>, <function>printf</function> und <function>flush</function>. Index: phpdoc-de/reference/strings/functions/printf.xml diff -u phpdoc-de/reference/strings/functions/printf.xml:1.3 phpdoc-de/reference/strings/functions/printf.xml:1.4 --- phpdoc-de/reference/strings/functions/printf.xml:1.3 Sun Jun 9 06:56:16 2002 +++ phpdoc-de/reference/strings/functions/printf.xml Tue Feb 11 14:03:44 2003 @@ -1,18 +1,16 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> -<!-- last change to 'printf' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.2 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.printf"> <refnamediv> <refname>printf</refname> <refpurpose>Gibt einen formatierten String aus</refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> - <type>int</type><methodname>printf</methodname> + <type>void</type><methodname>printf</methodname> <methodparam><type>string</type><parameter>format</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>args</parameter></methodparam> </methodsynopsis> @@ -22,9 +20,9 @@ <function>sprintf</function> näher beschrieben. </simpara> <simpara> - Siehe auch <function>print</function>, - <function>sprintf</function>, <function>sscanf</function>, - <function>fscanf</function> und <function>flush</function>. + Siehe auch <function>print</function>, <function>sprintf</function>, + <function>sscanf</function>, <function>fscanf</function> + und <function>flush</function>. </simpara> </refsect1> </refentry> Index: phpdoc-de/reference/strings/functions/quotemeta.xml diff -u phpdoc-de/reference/strings/functions/quotemeta.xml:1.3 phpdoc-de/reference/strings/functions/quotemeta.xml:1.4 --- phpdoc-de/reference/strings/functions/quotemeta.xml:1.3 Sun Jun 9 06:56:16 2002 +++ phpdoc-de/reference/strings/functions/quotemeta.xml Tue Feb 11 14:03:44 2003 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> -<!-- last change to 'quotemeta' in en/ tree in rev 1.139 --> -<!-- EN-Revision: 0.0 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.139 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.2 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.quotemeta"> <refnamediv> <refname>quotemeta</refname> <refpurpose>Quoten von Meta-Zeichen</refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>quotemeta</methodname> <methodparam><type>string</type><parameter>str</parameter></methodparam> @@ -18,8 +16,8 @@ <para> Der Inhalt von <parameter>str</parameter> wird mit einem Rückstrich ("Backslash", <literal>\</literal>) vor jedem Vorkommen - von <screen>. \\ + * ? [ ^ ] ( $ )</screen> versehen ("quoten")und - zurück gegeben. + von <screen>. \\ + * ? [ ^ ] ( $ )</screen> versehen ("quoten") und + zurückgegeben. </para> <simpara> Siehe auch <function>addslashes</function>,
Index: phpdoc-de/reference/strings/functions/parse-str.xml diff -u phpdoc-de/reference/strings/functions/parse-str.xml:1.4 phpdoc-de/reference/strings/functions/parse-str.xml:1.5 --- phpdoc-de/reference/strings/functions/parse-str.xml:1.4 Tue Aug 27 15:27:50 2002 +++ phpdoc-de/reference/strings/functions/parse-str.xml Tue Feb 11 14:03:44 2003 @@ -1,45 +1,66 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> -<!-- last change to 'parse-str' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.2 --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.parse-str"> <refnamediv> <refname>parse_str</refname> <refpurpose>Überträgt einen String in Variable</refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> <type>void</type><methodname>parse_str</methodname> <methodparam><type>string</type><parameter>str</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>arr</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>arr + </parameter></methodparam> </methodsynopsis> <para> Durchsucht <parameter>str</parameter> als ob er der Query-String - einer URL-Übergabe via GET wäre und gibt die Werte - Variableninhalte zurück. Ist der zweite Parameter - <parameter>arr</parameter> gegeben, werden die Variablen-Werte in - diesem Array als dessen Elemente gespeichert. + einer URL-Übergabe via GET wäre und erstellt Variablen im aktuellen + Geltungsbereich. Ist der zweite Parameter <parameter>arr</parameter> + angegeben, werden die Variablen in diesem Array als dessen Elemente + gespeichert. </para> <note> <para> Der optionale zweite Parameter wurde in PHP 4.0.3 hinzugefügt. </para> </note> - + <note> + <para> + Um auf den aktuellen <emphasis>QUERY_STRING</emphasis> zuzugreifen, + 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>. + </para> + </note> <para> <example> - <title>Der Gebrauch von <function>parse_str:</function></title> + <title>Der Gebrauch von <function>parse_str</function></title> <programlisting role="php"> -$str = "erster=nichts&zweiter[]=etwas&zweiter[]=nochwas"; +<![CDATA[ +<?php +$str = "first=value&arr[]=foo+bar&arr[]=baz"; parse_str($str); -echo $erster; /* gibt "nichts" aus */ -echo $zweiter[0]; /* gibt "etwas" aus */ -echo $zweiter[1]; /* gibt "nochwas" aus */ +echo $first; // value +echo $arr[0]; // foo bar +echo $arr[1]; // baz + +parse_str($str, $output); +echo $output['first']; // value +echo $output['arr'][0]; // foo bar +echo $output['arr'][1]; // baz + +?> +]]> </programlisting> </example> + </para> + <para> + Siehe auch <function>parse_url</function>, <function>pathinfo</function>, + <function>set_magic_quotes_runtime</function> und <function>urldecode</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/strings/functions/print.xml diff -u phpdoc-de/reference/strings/functions/print.xml:1.3 phpdoc-de/reference/strings/functions/print.xml:1.4 --- phpdoc-de/reference/strings/functions/print.xml:1.3 Sun Jun 9 06:56:16 2002 +++ phpdoc-de/reference/strings/functions/print.xml Tue Feb 11 14:03:44 2003 @@ -1,23 +1,67 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> -<!-- last change to 'print' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.2 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.print"> <refnamediv> <refname>print</refname> <refpurpose>Ausgabe eines Strings</refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> - <methodname>print</methodname> + <type>void</type><methodname>print</methodname> <methodparam><type>string</type><parameter>arg</parameter></methodparam> </methodsynopsis> <simpara> - Gibt <parameter>arg</parameter> aus. + Gibt <parameter>arg</parameter> aus. &return.success; </simpara> + <para> + <function>print</function> ist eigentlich keine wirkliche Funktion + (sie ist ein Sprachkonstukt), weshalb Sie beim Aufruf nicht unbedingt + Klammern benutzen müssen. + </para> + <example> + <title><function>print</function> Beispiele</title> + <programlisting role="php"> +<![CDATA[ +<?php +print("Hello World"); + +print "print() funktioniert auch ohne Klammern."; + +print "Dies umfasst +mehrere Zeilen. Die Zeilenumbrüche werden +ebenfalls ausgegeben"; + +print "Dies hat\nmehrere Zeilen. Die Umbrüche werden\nauch ausgegeben."; + +print "Escape-Zeichen werden \"so\" geschrieben."; + +// Sie können in einer print-Anweisung auch Variablen benutzen +$foo = "foobar"; +$bar = "barbaz"; + +print "foo is $foo"; // foo ist foobar + +// Einfache Anführungsstriche geben den Variablennamen aus, +// nicht den Inhalt +print 'foo is $foo'; // foo ist $foo + +// Benutzen Sie keine anderen Zeichen, können Sie auch nur +// Variablen ausgeben +print $foo; // foobar + +print <<<END +Dies verwendet die "here document" Syntax zur Ausgabe von +mehreren Zeilen mit $variablen Interpolation. Beachten Sie, +dass das "here document" Endezeichen in einer Zeile nur mit +einem Semikolon ohne Whitespaces stehen muss! +END; +?> +]]> + </programlisting> + </example> <simpara> Siehe auch <function>echo</function>, <function>printf</function> und <function>flush</function>. Index: phpdoc-de/reference/strings/functions/printf.xml diff -u phpdoc-de/reference/strings/functions/printf.xml:1.3 phpdoc-de/reference/strings/functions/printf.xml:1.4 --- phpdoc-de/reference/strings/functions/printf.xml:1.3 Sun Jun 9 06:56:16 2002 +++ phpdoc-de/reference/strings/functions/printf.xml Tue Feb 11 14:03:44 2003 @@ -1,18 +1,16 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> -<!-- last change to 'printf' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.2 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.printf"> <refnamediv> <refname>printf</refname> <refpurpose>Gibt einen formatierten String aus</refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> - <type>int</type><methodname>printf</methodname> + <type>void</type><methodname>printf</methodname> <methodparam><type>string</type><parameter>format</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>args</parameter></methodparam> </methodsynopsis> @@ -22,9 +20,9 @@ <function>sprintf</function> näher beschrieben. </simpara> <simpara> - Siehe auch <function>print</function>, - <function>sprintf</function>, <function>sscanf</function>, - <function>fscanf</function> und <function>flush</function>. + Siehe auch <function>print</function>, <function>sprintf</function>, + <function>sscanf</function>, <function>fscanf</function> + und <function>flush</function>. </simpara> </refsect1> </refentry> Index: phpdoc-de/reference/strings/functions/quotemeta.xml diff -u phpdoc-de/reference/strings/functions/quotemeta.xml:1.3 phpdoc-de/reference/strings/functions/quotemeta.xml:1.4 --- phpdoc-de/reference/strings/functions/quotemeta.xml:1.3 Sun Jun 9 06:56:16 2002 +++ phpdoc-de/reference/strings/functions/quotemeta.xml Tue Feb 11 14:03:44 2003 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> -<!-- last change to 'quotemeta' in en/ tree in rev 1.139 --> -<!-- EN-Revision: 0.0 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.139 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.2 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.quotemeta"> <refnamediv> <refname>quotemeta</refname> <refpurpose>Quoten von Meta-Zeichen</refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>quotemeta</methodname> <methodparam><type>string</type><parameter>str</parameter></methodparam> @@ -18,8 +16,8 @@ <para> Der Inhalt von <parameter>str</parameter> wird mit einem Rückstrich ("Backslash", <literal>\</literal>) vor jedem Vorkommen - von <screen>. \\ + * ? [ ^ ] ( $ )</screen> versehen ("quoten")und - zurück gegeben. + von <screen>. \\ + * ? [ ^ ] ( $ )</screen> versehen ("quoten") und + zurückgegeben. </para> <simpara> Siehe auch <function>addslashes</function>,