cvs: phpdoc-de /reference/strings/functions sprintf.xml sscanf.xml str-repeat.xml strnatcmp.xml substr-count.xml substr.xml wordwrap.xml
| From: | Thomas Schoefbeck | Date: | Wed, 22 Jan 2003 22:02:13 +0000 |
| Subject: | cvs: phpdoc-de /reference/strings/functions sprintf.xml sscanf.xml str-repeat.xml strnatcmp.xml substr-count.xml substr.xml wordwrap.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-451@lists.php.net to get a copy of this message | ||
tom Wed Jan 22 17:02:13 2003 EDT
Modified files:
/phpdoc-de/reference/strings/functions sprintf.xml sscanf.xml
str-repeat.xml strnatcmp.xml
substr-count.xml substr.xml
wordwrap.xml
Log:
sync to en
Index: phpdoc-de/reference/strings/functions/sprintf.xml diff -u phpdoc-de/reference/strings/functions/sprintf.xml:1.3 phpdoc-de/reference/strings/functions/sprintf.xml:1.4 --- phpdoc-de/reference/strings/functions/sprintf.xml:1.3 Sun Jun 9 06:56:16 2002 +++ phpdoc-de/reference/strings/functions/sprintf.xml Wed Jan 22 17:02:12 2003 @@ -1,9 +1,7 @@ <?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 'sprintf' 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.5 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.sprintf"> <refnamediv> <refname>sprintf</refname> @@ -25,46 +23,46 @@ gebildet: Gewöhnliche Zeichen (ausser <literal>%</literal>), die direkt in das Ergebnis übertragen werden und <emphasis>Umsetzungs-Anweisungen</emphasis>. Jede dieser - Anweisungen resultiert ihre eigene Auswirkung. Diese Anweisungen - gelten sowohl für die <function>sprintf</function>- als auch für - die <function>printf</function>-Funktion. + Anweisungen holt sich als Resultat ihre eigenen Parameter. Diese + Anweisungen gelten sowohl für die <function>sprintf</function>- + als auch für die <function>printf</function>-Funktion. </simpara> <para> Jede der Formatierugs-Anweisungen besteht aus einem - Prozent-Zeichen gefolgt von einem oder mehrereren der folgenden - Elemente (in alphabetischer Reihenfolge): + Prozent-Zeichen (<literal>%</literal>), gefolgt von einem oder mehrereren + der folgenden Elemente: <orderedlist> <listitem> <simpara> Einem optionalen <emphasis>Füll-Zeichen</emphasis>, das den String bis rechts auffüllt. Dies kann ein Leerzeichen oder eine - <literal>0</literal> (das Null-Zeichen) sein. Als Füllzeichen - voreingestellt ist das Leerzeichen. Andere Füllzeichen können - durch Voranstellung eines einfachen Anführungszeichens - (<literal>'</literal>) definiert werden. Beachten Sie die - folgenden Beispiele. + <literal>0</literal> (das Null-Zeichen) sein. Standardmäßig wird + mit dem Leerzeichen gefüllt. Andere Füllzeichen können durch + Voranstellen eines einfachen Anführungszeichens (<literal>'</literal>) + definiert werden. Beachten Sie die nachstehenden Beispiele. </simpara> </listitem> <listitem> <simpara> Einer optionalen Angabe der <emphasis>Ausrichtung</emphasis>, - ob die Ausgabe also nach links oder nach rechts (default) - ausgerichtet werden soll. Um den Text links auszurichten müssen - Sie das Zeichen <literal>-</literal> angeben. + ob die Ausgabe nach links oder nach rechts (default) ausgerichtet + werden soll. Standardmäßig ist die Ausrichtung rechtsbündig. + Um den Text linksbündig auszurichten müssen Sie das Zeichen + <literal>-</literal> angeben. </simpara> </listitem> <listitem> <simpara> - Optional einem Wert für die <emphasis>Längen-Angabe</emphasis>, - also der Wert für die mindestenst zurückzugebenden Zeichen. + Einer optionalen Zahl für die <emphasis>Längen-Angabe</emphasis>, + welche die mindestens zurückzugebende Anzahl Zeichen spezifiziert. </simpara> </listitem> <listitem> <simpara> - Optional einem Wert für die Anzahl der auszugebenden - <emphasis>Nachkomma-Stellen</emphasis>. Dieser Wert hat nur - Einfluss auf Werte vom Typ "double" (eine weitere hilfreiche - Funktion für die Formatierung von Zahlen ist + Einem optionalen Wert für die Anzahl der auszugebenden + <emphasis>Dezimalstellen</emphasis> für Fließkommazahlen. Dieser + Wert hat nur Einfluss auf Werte vom Typ <type>float</type> (eine + weitere hilfreiche Funktion zur Formatierung von Zahlen ist <function>number_format</function>). </simpara> </listitem> @@ -89,19 +87,23 @@ </member> <member> <literal>d</literal> - das Argument wird als Integer - angesehen und ein Dezimalwert ausgegeben. + angesehen und ein Dezimalwert (signed) ausgegeben. </member> <member> - <literal>f</literal> - das Argument wird als "double" + <literal>u</literal> - das Argument wird als Integer + angesehen und ein Dezimalwert (unsigned) ausgegeben. + </member> + <member> + <literal>f</literal> - das Argument wird als <type>float</type> angesehen und eine Fließkomma-Zahl ausgegeben. </member> <member> <literal>o</literal> - das Argument wird als Integer - angesehen und und als Oktalwert ausgegeben. + angesehen und und als Oktalzahl ausgegeben. </member> <member> <literal>s</literal> - das Argument wird als String angesehen - und als solcher ausgegeben. + und auch als solcher ausgegeben. </member> <member> <literal>x</literal> - das Argument wird als Integer @@ -118,6 +120,58 @@ </listitem> </orderedlist> </para> + <para> + Seit PHP 4.0.6 unterstützt der Formatstring auch Argumente zu + numerieren/tauschen. Hier ein Beispiel: + <example> + <title>Argumente tauschen</title> + <programlisting role="php"> +<![CDATA[ +$format = "There are %d monkeys in the %s"; +printf($format,$num,$location); +]]> + </programlisting> + </example> + Dies könnte "There are 5 monkeys in the tree" ausgeben. Aber nehmen + wir einmal an, dass wir den Formatstring in einer separaten Datei + erstellen, da wir ihn internationalisieren wollen, und deshalb wie + folgt umschreiben: + <example> + <title>Argumente tauschen</title> + <programlisting role="php"> +<![CDATA[ +$format = "The %s contains %d monkeys"; +printf($format,$num,$location); +]]> + </programlisting> + </example> + Nun haben wir ein Problem. Die Reihenfolge der Platzhalter des + Formatstrings entspricht nicht mehr der Reihenfolge der Argumente im + Code. Wir würden gerne den Code belassen wie er ist, und einfach im + Formatstring angeben, welchen Argumenten die Platzhalter entsprechen. + Wir würden dann den Formatstring wie folt schreiben: + <example> + <title>Argumente tauschen</title> + <programlisting role="php"> +<![CDATA[ +$format = "The %2\$s contains %1\$d monkeys"; +printf($format,$num,$location); +]]> + </programlisting> + </example> + Ein weiterer Vorteil ist, dass wir nun die Platzhalter wiederholen + können, ohne mehr Argumente im Code hinzufügen zu müssen. Zum Beispiel: + <example> + <title>Argumente tauschen</title> + <programlisting role="php"> +<![CDATA[ +$format = "The %2\$s contains %1\$d monkeys. + That's a nice %2\$s full of %1\$d monkeys."; +printf($format, $num, $location); +]]> + </programlisting> + </example> + </para> <simpara> Siehe auch: <function>printf</function>, <function>sscanf</function>, <function>fscanf</function> und @@ -128,33 +182,24 @@ <title>Beispiele:</title> <para> <example> - <title> - <function>sprintf</function>: Null-gefüllte Integer-Werte - </title> + <title><function>sprintf</function>: Null-gefüllte Integer-Werte</title> <programlisting role="php"> +<![CDATA[ $isodatum = sprintf ("%04d-%02d-%02d", $jahr, $monat, $tag); +]]> </programlisting> </example> <example> - <title> - <function>sprintf</function>: Integer- zu Binärwert - </title> - <programlisting role="php"> -$wert = 155; -$binaer = sprintf ("%b", $wert); -echo ("<br> $binaer <br>"); -// gibt 10011011 aus - </programlisting> - </example> - <example> - <title><function>sprintf</function>: Währungsformatierung</title> + <title><function>sprintf</function>: Währung formatieren</title> <programlisting role="php"> +<![CDATA[ $money1 = 68.75; $money2 = 54.35; $money = $money1 + $money2; -// echo $money wird "123.1" ausgeben -$formatiert = sprintf ("%01.2f", $money); -// echo $formatiert wird "123.10" ausgeben +// echo $money wird ausgeben "123.1"; +$formatted = sprintf("%01.2f", $money); +// echo $formatted wird ausgeben "123.10" +]]> </programlisting> </example> </para> Index: phpdoc-de/reference/strings/functions/sscanf.xml diff -u phpdoc-de/reference/strings/functions/sscanf.xml:1.3 phpdoc-de/reference/strings/functions/sscanf.xml:1.4 --- phpdoc-de/reference/strings/functions/sscanf.xml:1.3 Sun Jun 9 06:56:16 2002 +++ phpdoc-de/reference/strings/functions/sscanf.xml Wed Jan 22 17:02:13 2003 @@ -1,14 +1,12 @@ <?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 'sscanf' in en/ tree in rev 1.33 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.33 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.sscanf"> <refnamediv> <refname>sscanf</refname> <refpurpose> - Übertragt die Eingaben eines Strings in ein angegebenes Format + Überträgt einen String in ein angegebenes Format </refpurpose> </refnamediv> <refsect1> @@ -22,19 +20,29 @@ <para> Die Funktion <function>sscanf</function> ist die Eingabe analog zu <function>printf</function>. <function>sscanf</function> liest den - <parameter>str</parameter>-String und interpretiert ihn Anlehnung - an die angegebenen <parameter>format</parameter> Parameter. Werden + String <parameter>str</parameter> und interpretiert ihn entsprechend + dem angegebenen Parameter <parameter>format</parameter>. Werden nur 2 Parameter angegeben, werden die analysierten Werte als Array - zurück gegeben. + zurückgegeben. + </para> + <para> + Irgendwelche Whitespaces in dem Formatstring entsprechen auch irgendwelchen + Whitespaces in dem übergebenen String. Das heißt, dass auch ein Tabulator + \t im Formatstring einem einzelnen Leerzeichen des übergebenen Strings + entsprechen kann. + </para> + <para> <example> <title><function>sscanf</function>-Beispiel:</title> <programlisting role="php"> +<![CDATA[ // Ermittlung der Serien-Nr. $serial = sscanf("SN/2350001","SN/%d"); // und des Herstellungsdatums $mandate = "Januar 01 2000"; 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 @@ -42,16 +50,17 @@ refenziert übergeben werden. <example> <title> - <function>sscanf</function> - Gebrauch optionaler Parameter - </title> + <function>sscanf</function> - Gebrauch optionaler Parameter</title> <programlisting role="php"> +<![CDATA[ // Ermittlung der Autoren-Info und Erzeugung eines DocBook-Eintrages $auth = "24\tLewis Carroll"; -$n = sscanf($auth,"%d\t%s %s", &$id, &$first, &$last); -echo "<author id='$id'> - <firstname>$first</firstname> - <surname>$last</surname> - </author>\n"; +$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> Index: phpdoc-de/reference/strings/functions/str-repeat.xml diff -u phpdoc-de/reference/strings/functions/str-repeat.xml:1.3 phpdoc-de/reference/strings/functions/str-repeat.xml:1.4 --- phpdoc-de/reference/strings/functions/str-repeat.xml:1.3 Sun Jun 9 06:56:16 2002 +++ phpdoc-de/reference/strings/functions/str-repeat.xml Wed Jan 22 17:02:13 2003 @@ -1,13 +1,11 @@ <?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 'str-repeat' 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.5 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.str-repeat"> <refnamediv> <refname>str_repeat</refname> - <refpurpose>Wiederholung eine String-Ausgabe</refpurpose> + <refpurpose>Wiederholt eine String-Ausgabe</refpurpose> </refnamediv> <refsect1> <title>Beschreibung:</title> @@ -17,24 +15,26 @@ <methodparam><type>int</type><parameter>multiplier</parameter></methodparam> </methodsynopsis> <para> - Die Ausgabe von <parameter>input_str</parameter> wird - <parameter>multiplier</parameter> mal wiederholt. - <parameter>Multiplier</parameter> muss grösser als 0 sein. + Gibt <parameter>input_str</parameter> <parameter>multiplier</parameter> + mal zurück, wobei <parameter>multiplier</parameter> größer als 0 sein + muss. </para> <example> <title><function>str_repeat</function>-Beispiel:</title> <programlisting role="php"> +<![CDATA[ echo str_repeat ("-=", 10); +]]> </programlisting> </example> <para> Es wird "-=-=-=-=-=-=-=-=-=-=" ausgegeben. </para> - <note> - <para> - Verfügbar ab PHP 4.0. - </para> - </note> + <para> + Siehe auch <link linkend="control-structures.for">for</link>, + <function>str_pad</function> und + <function>substr_count</function>. + </para> </refsect1> </refentry> Index: phpdoc-de/reference/strings/functions/strnatcmp.xml diff -u phpdoc-de/reference/strings/functions/strnatcmp.xml:1.3 phpdoc-de/reference/strings/functions/strnatcmp.xml:1.4 --- phpdoc-de/reference/strings/functions/strnatcmp.xml:1.3 Sun Jun 9 06:56:17 2002 +++ phpdoc-de/reference/strings/functions/strnatcmp.xml Wed Jan 22 17:02:13 2003 @@ -1,9 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.23 --> -<!-- last change to 'strnatcmp' in en/ tree in rev 1.38 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.38 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.strnatcmp"> <refnamediv> <refname>strnatcmp</refname> @@ -19,46 +17,50 @@ <methodparam><type>string</type><parameter>str2</parameter></methodparam> </methodsynopsis> <para> - Diese Funktion implemetiert einen Vergleich, der alphanumerische - Zeichen "menschlich" einordnet (auch "natürliche Ordnung" - genannt). Der Unterschied zwischen dieser und der regulären - String-Sortierung eines Computer (unter Verwendung von + Diese Funktion implemetiert einen Vergleichsalgorithmus, der + alphanumerische Zeichenketten "menschlich" ordnet (auch "natürliche + Ordnung" genannt). Der Unterschied zwischen dieser und der regulären + String-Sortierung eines Computers (verwendet in <function>strcmp</function>) wird in dem folgenden Beispiel gezeigt: <informalexample> - <programlisting> -$arr1 = $arr2 = array ("img12.png","img10.png","img2.png","img1.png"); + <programlisting role="php"> +<![CDATA[ +$arr1 = $arr2 = array("img12.png","img10.png","img2.png","img1.png"); echo "Normaler String-Vergleich\n"; usort($arr1,"strcmp"); print_r($arr1); echo "\nVergleich mittels natürlicher Ordnung\n"; usort($arr2,"strnatcmp"); print_r($arr2); +]]> </programlisting> </informalexample> Der o.a. Code erzeugt die folgende Ausgabe: <informalexample> - <programlisting> + <screen> +<![CDATA[ Normaler String-Vergleich Array ( - [0] => img1.png - [1] => img10.png - [2] => img12.png - [3] => img2.png + [0] => img1.png + [1] => img10.png + [2] => img12.png + [3] => img2.png ) Vergleich mittels natürlicher Ordnung Array ( - [0] => img1.png - [1] => img2.png - [2] => img10.png - [3] => img12.png + [0] => img1.png + [1] => img2.png + [2] => img10.png + [3] => img12.png ) - </programlisting> +]]> + </screen> </informalexample> - Für weitere Infos siehe Martin Pool's <ulink + Weitere Informationen finden Sie auf Martin Pool's <ulink url="&url.strnatcmp;">Natural Order String Comparison</ulink> Seite. </para> @@ -76,9 +78,9 @@ Siehe auch <function>ereg</function>, <function>strcasecmp</function>, <function>substr</function>, <function>stristr</function>, <function>strcmp</function>, - <function>strncmp</function>, <function>strnatcasecmp</function>, - <function>strstr</function>, <function>natsort</function> und - <function>natcasesort</function> . + <function>strncmp</function>, <function>strncasecmp</function>, + <function>strnatcasecmp</function>, <function>strstr</function>, + <function>natsort</function> und <function>natcasesort</function>. </simpara> </refsect1> </refentry> Index: phpdoc-de/reference/strings/functions/substr-count.xml diff -u phpdoc-de/reference/strings/functions/substr-count.xml:1.3 phpdoc-de/reference/strings/functions/substr-count.xml:1.4 --- phpdoc-de/reference/strings/functions/substr-count.xml:1.3 Sun Jun 9 06:56:17 2002 +++ phpdoc-de/reference/strings/functions/substr-count.xml Wed Jan 22 17:02:13 2003 @@ -1,40 +1,45 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.20 --> -<!-- last change to 'substr-count' in en/ tree in rev 1.27 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.27 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.substr-count"> <refnamediv> <refname>substr_count</refname> <refpurpose> - Ermittelt die Häufigkeit des Vorkommens einer Zeichenkette in - einem String + Ermittelt, wie oft eine Zeichenkette in einem String vorkommt </refpurpose> </refnamediv> <refsect1> <title>Beschreibung:</title> <methodsynopsis> <type>int</type><methodname>substr_count</methodname> - <methodparam><type>string</type><parameter>haystrack</parameter></methodparam> + <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>string</type><parameter>needle</parameter></methodparam> </methodsynopsis> <para> Die Funktion <function>substr_count</function> ermittelt, wie oft <parameter>needle</parameter> in dem String - <parameter>haystack</parameter> vorkommt. + <parameter>haystack</parameter> vorkommt, und gibt die Anzahl der + Vorkommen zurück. </para> + <para> <example> <title><function>substr_count</function>-Beispiel:</title> - <programlisting> + <programlisting role="php"> +<![CDATA[ +<?php print substr_count("Dieser Test ist Mist", "ist"); // ergibt 2 +?> +]]> </programlisting> </example> </para> - <para> - Diese Funktion steht ab PHP 4.0.0 zur Verfügung. - </para> + <simpara> + Siehe auch <function>count_chars</function>, + <function>strpos</function>, <function>substr</function> + und <function>strstr</function>. + </simpara> </refsect1> </refentry> Index: phpdoc-de/reference/strings/functions/substr.xml diff -u phpdoc-de/reference/strings/functions/substr.xml:1.3 phpdoc-de/reference/strings/functions/substr.xml:1.4 --- phpdoc-de/reference/strings/functions/substr.xml:1.3 Sun Jun 9 06:56:17 2002 +++ phpdoc-de/reference/strings/functions/substr.xml Wed Jan 22 17:02:13 2003 @@ -1,13 +1,11 @@ <?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 'substr' 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.6 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.substr"> <refnamediv> <refname>substr</refname> - <refpurpose>Gibt einen Teilstring zurück</refpurpose> + <refpurpose>Gibt einen Teil eines Strings zurück</refpurpose> </refnamediv> <refsect1> <title>Beschreibung:</title> @@ -18,10 +16,10 @@ <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> </methodsynopsis> <para> - <function>substr</function> gibt den Teil von - <parameter>string</parameter> zurück, der durch die + <function>substr</function> gibt den Teil von + <parameter>string</parameter> zurück, der durch die Parameter <parameter>start</parameter> und <parameter>length</parameter> - Parameter definiert wurde. + definiert wurde. </para> <para> Wenn <parameter>start</parameter> positiv ist, beginnt der zurück @@ -31,36 +29,71 @@ <literal>0</literal> gleich '<literal>a</literal>', das Zeichen an der Position <literal>2</literal> ist '<literal>c</literal>' usw. </para> + <example> + <title>Generelle Verwendung von <function>substr</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +$rest = substr("abcdef", 1); // gibt "bcdef" zurück +$rest = substr("abcdef", 1, 3); // gibt "bcd" zurück +$rest = substr("abcdef", 0, 4); // gibt "abcd" zurück +$rest = substr("abcdef", 0, 8); // gibt "abcdef" zurück + +// Der Zugriff mittels geschwungenen Klammer ist eine +// weitere Möglickeit +$string = 'abcdef'; +echo $string{0}; // gibt a zurück +echo $string{3}; // gibt d zurück +?> +]]> + </programlisting> + </example> <para> - Beispiele: - <informalexample> - <programlisting role="php"> -$rest = substr ("abcdef", 1); // gibt "bcdef" zurück -$rest = substr ("abcdef", 1, 3); // gibt "bcd" zurück - </programlisting> - </informalexample> + Ist <parameter>start</parameter> negativ, beginnt der zurückgegebene + String bei dem <parameter>start</parameter>'en Zeichen vom Ende von + <parameter>string</parameter>. </para> + <example> + <title>Negativen <parameter>start</parameter> verwenden</title> + <programlisting role="php"> +<![CDATA[ +<?php +$rest = substr("abcdef", -1); // gibt "f" zurück +$rest = substr("abcdef", -2); // gibt "ef" zurück +$rest = substr("abcdef", -3, 1); // gibt "d" zurück +?> +]]> + </programlisting> + </example> <para> - Ist <parameter>start</parameter> negativ, gibt er den Beginn-Wert - ab Ende des Strings an (also rückwärts gezählt). - </para> + Ist <parameter>length</parameter> angegeben und positiv, enthält der + zurückgegebene String höchstens <parameter>length</parameter> Zeichen + ab <parameter>start</parameter> (abhängig von der Länge von + <parameter>string</parameter>). Ist <parameter>string</parameter> + kürzer als <parameter>start</parameter> Zeichen, wird &false; + zurückgegeben. + </para> <para> - Beispiele: - <informalexample> - <programlisting role="php"> -$rest = substr ("abcdef", -1); // gibt "f" zurück -$rest = substr ("abcdef", -2); // gibt "ef" zurück -$rest = substr ("abcdef", -3, 1); // gibt "d" zurück -$rest = substr ("abcdef", 1, -1); // gibt "bcde" zurück -$rest = substr ("abcdef", 4, -4); // gibt "" zurück (nichts) -$rest = substr ("abcdef", 7, 1); // gibt "" zurück (nichts) -$rest = substr ("abcdef", 7, -4); // gibt "" zurück (nichts) -$rest = substr ("abcdef", 4, 4); // gibt "ef" zurück -$rest = substr ("abcdef", -2, 4); // gibt "ef" zurück -$rest = substr ("abcdef", -5, -4); // gibt "b" zurück - </programlisting> - </informalexample> + Ist <parameter>length</parameter> angegeben und negativ, dann werden + genauso viele Zeichen vom Ende von <parameter>string</parameter> + abgeschnitten (nachdem die Starposition ermittelt wurde, sollte + <parameter>start</parameter> negativ sein). Gibt + <parameter>start</parameter> eine Position hinter dem abzuschneidenden + Teil an, wird ein leerer String zurückgegeben. </para> + <example> + <title>Negative <parameter>length</parameter> verwenden</title> + <programlisting role="php"> +<![CDATA[ +<?php +$rest = substr("abcdef", 0, -1); // gibt "abcde" zurück +$rest = substr("abcdef", 2, -1); // gibt "cde" zurück +$rest = substr("abcdef", 4, -4); // gibt "" zurück +$rest = substr("abcdef", -3, -1); // gibt "de" zurück +?> +]]> + </programlisting> + </example> <para> Siehe auch <function>strrchr</function> und <function>ereg</function>. Index: phpdoc-de/reference/strings/functions/wordwrap.xml diff -u phpdoc-de/reference/strings/functions/wordwrap.xml:1.2 phpdoc-de/reference/strings/functions/wordwrap.xml:1.3 --- phpdoc-de/reference/strings/functions/wordwrap.xml:1.2 Sun Jun 9 06:56:17 2002 +++ phpdoc-de/reference/strings/functions/wordwrap.xml Wed Jan 22 17:02:13 2003 @@ -1,15 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> -<!-- last change to 'wordwrap' in en/ tree in rev 1.142 --> -<!-- EN-Revision: 0.0 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.142 --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.wordwrap"> <refnamediv> <refname>wordwrap</refname> <refpurpose> - Zeilenumbruch eines Strings an einer angegebenen Stelle unter - Verwendung eines angegebenen Trennzeichens + Bricht die Zeilen eines Strings nach einer bestimmten Anzahl + Zeichen mittels des angegebenen Trennzeichens um. </refpurpose> </refnamediv> <refsect1> @@ -22,30 +20,41 @@ <methodparam choice="opt"><type>int</type><parameter>cut</parameter></methodparam> </methodsynopsis> <para> - Bricht den String <parameter>str</parameter> an der mittels - <parameter>width</parameter> angegebenen - Position in die nächste Zeile um. Der Umbruch geschieht mit - dem <parameter>break</parameter> Parameter. + Bricht die Zeilen des Strings <parameter>str</parameter> an der + mittels <parameter>width</parameter> angegebenen Position um. + Diese Zeilenumbrüche werden mit dem im (optionalen) Parameter + <parameter>break</parameter> spezifizierten Steuerzeichen + durchgeführt. </para> <para> - Die Funktion <function>wordwrap</function> bricht selbst an der - Spalte 75 unter Verwendung des Steuerzeichens '\n' (neue Zeile) - um, wenn die optionalen Parameter <parameter>width</parameter> - und / oder <parameter>break</parameter> nicht angegeben werden. + Die Funktion <function>wordwrap</function> bricht die Zeilen + automatisch an der Spalte 75 unter Verwendung des Steuerzeichens + '\n' (neue Zeile) um, wenn die optionalen Parameter + <parameter>width</parameter> und / oder <parameter>break</parameter> + nicht angegeben sind. </para> <para> Steht <parameter>cut</parameter> auf 1, wird der String immer an der vorgegebenen Länge umgebrochen. Ist ein Wort also länger als - die gegebene Länge, wird es mitten drin umgebrochen (siehe zweites - Beispiel) + die gegebene Länge, wird der Zeilumbruch auch innerhalb des Wortes + eingefügt (siehe zweites Beispiel). + <note> + <para> + Der optionale Parameter <parameter>cut</parameter> wurde in PHP 4.0.3 + eingeführt. + </para> + </note> </para> <para> <example> <title><function>wordwrap</function>-Beispiel:</title> <programlisting role="php"> -$text = "Der schnelle braune Fuchs springt über den blöden Hund."; +<![CDATA[ +$text = "Der schnelle braune Fuchs sprang über den faulen Hund."; $neuertext = wordwrap( $text, 20 ); + echo "$neuertext\n"; +]]> </programlisting> </example> </para> @@ -54,19 +63,25 @@ </para> <para> <informalexample> - <programlisting> + <screen> +<![CDATA[ Der schnelle braune -Fuchs springt über den blöden Hund. - </programlisting> +Fuchs sprang über +den faulen Hund. +]]> + </screen> </informalexample> </para> <para> <example> <title><function>wordwrap</function> example</title> <programlisting role="php"> +<![CDATA[ $text = "Ein sehr langes Wooooooooooort."; $neuertext = wordwrap( $text, 8, "\n", 1); + echo "$neuertext\n"; +]]> </programlisting> </example> </para> @@ -75,12 +90,14 @@ </para> <para> <informalexample> - <programlisting> + <screen> +<![CDATA[ Ein sehr -langes W -oooooooo -ooort. - </programlisting> +langes +Wooooooo +oooort. +]]> + </screen> </informalexample> </para> <para>
Index: phpdoc-de/reference/strings/functions/sprintf.xml diff -u phpdoc-de/reference/strings/functions/sprintf.xml:1.3 phpdoc-de/reference/strings/functions/sprintf.xml:1.4 --- phpdoc-de/reference/strings/functions/sprintf.xml:1.3 Sun Jun 9 06:56:16 2002 +++ phpdoc-de/reference/strings/functions/sprintf.xml Wed Jan 22 17:02:12 2003 @@ -1,9 +1,7 @@ <?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 'sprintf' 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.5 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.sprintf"> <refnamediv> <refname>sprintf</refname> @@ -25,46 +23,46 @@ gebildet: Gewöhnliche Zeichen (ausser <literal>%</literal>), die direkt in das Ergebnis übertragen werden und <emphasis>Umsetzungs-Anweisungen</emphasis>. Jede dieser - Anweisungen resultiert ihre eigene Auswirkung. Diese Anweisungen - gelten sowohl für die <function>sprintf</function>- als auch für - die <function>printf</function>-Funktion. + Anweisungen holt sich als Resultat ihre eigenen Parameter. Diese + Anweisungen gelten sowohl für die <function>sprintf</function>- + als auch für die <function>printf</function>-Funktion. </simpara> <para> Jede der Formatierugs-Anweisungen besteht aus einem - Prozent-Zeichen gefolgt von einem oder mehrereren der folgenden - Elemente (in alphabetischer Reihenfolge): + Prozent-Zeichen (<literal>%</literal>), gefolgt von einem oder mehrereren + der folgenden Elemente: <orderedlist> <listitem> <simpara> Einem optionalen <emphasis>Füll-Zeichen</emphasis>, das den String bis rechts auffüllt. Dies kann ein Leerzeichen oder eine - <literal>0</literal> (das Null-Zeichen) sein. Als Füllzeichen - voreingestellt ist das Leerzeichen. Andere Füllzeichen können - durch Voranstellung eines einfachen Anführungszeichens - (<literal>'</literal>) definiert werden. Beachten Sie die - folgenden Beispiele. + <literal>0</literal> (das Null-Zeichen) sein. Standardmäßig wird + mit dem Leerzeichen gefüllt. Andere Füllzeichen können durch + Voranstellen eines einfachen Anführungszeichens (<literal>'</literal>) + definiert werden. Beachten Sie die nachstehenden Beispiele. </simpara> </listitem> <listitem> <simpara> Einer optionalen Angabe der <emphasis>Ausrichtung</emphasis>, - ob die Ausgabe also nach links oder nach rechts (default) - ausgerichtet werden soll. Um den Text links auszurichten müssen - Sie das Zeichen <literal>-</literal> angeben. + ob die Ausgabe nach links oder nach rechts (default) ausgerichtet + werden soll. Standardmäßig ist die Ausrichtung rechtsbündig. + Um den Text linksbündig auszurichten müssen Sie das Zeichen + <literal>-</literal> angeben. </simpara> </listitem> <listitem> <simpara> - Optional einem Wert für die <emphasis>Längen-Angabe</emphasis>, - also der Wert für die mindestenst zurückzugebenden Zeichen. + Einer optionalen Zahl für die <emphasis>Längen-Angabe</emphasis>, + welche die mindestens zurückzugebende Anzahl Zeichen spezifiziert. </simpara> </listitem> <listitem> <simpara> - Optional einem Wert für die Anzahl der auszugebenden - <emphasis>Nachkomma-Stellen</emphasis>. Dieser Wert hat nur - Einfluss auf Werte vom Typ "double" (eine weitere hilfreiche - Funktion für die Formatierung von Zahlen ist + Einem optionalen Wert für die Anzahl der auszugebenden + <emphasis>Dezimalstellen</emphasis> für Fließkommazahlen. Dieser + Wert hat nur Einfluss auf Werte vom Typ <type>float</type> (eine + weitere hilfreiche Funktion zur Formatierung von Zahlen ist <function>number_format</function>). </simpara> </listitem> @@ -89,19 +87,23 @@ </member> <member> <literal>d</literal> - das Argument wird als Integer - angesehen und ein Dezimalwert ausgegeben. + angesehen und ein Dezimalwert (signed) ausgegeben. </member> <member> - <literal>f</literal> - das Argument wird als "double" + <literal>u</literal> - das Argument wird als Integer + angesehen und ein Dezimalwert (unsigned) ausgegeben. + </member> + <member> + <literal>f</literal> - das Argument wird als <type>float</type> angesehen und eine Fließkomma-Zahl ausgegeben. </member> <member> <literal>o</literal> - das Argument wird als Integer - angesehen und und als Oktalwert ausgegeben. + angesehen und und als Oktalzahl ausgegeben. </member> <member> <literal>s</literal> - das Argument wird als String angesehen - und als solcher ausgegeben. + und auch als solcher ausgegeben. </member> <member> <literal>x</literal> - das Argument wird als Integer @@ -118,6 +120,58 @@ </listitem> </orderedlist> </para> + <para> + Seit PHP 4.0.6 unterstützt der Formatstring auch Argumente zu + numerieren/tauschen. Hier ein Beispiel: + <example> + <title>Argumente tauschen</title> + <programlisting role="php"> +<![CDATA[ +$format = "There are %d monkeys in the %s"; +printf($format,$num,$location); +]]> + </programlisting> + </example> + Dies könnte "There are 5 monkeys in the tree" ausgeben. Aber nehmen + wir einmal an, dass wir den Formatstring in einer separaten Datei + erstellen, da wir ihn internationalisieren wollen, und deshalb wie + folgt umschreiben: + <example> + <title>Argumente tauschen</title> + <programlisting role="php"> +<![CDATA[ +$format = "The %s contains %d monkeys"; +printf($format,$num,$location); +]]> + </programlisting> + </example> + Nun haben wir ein Problem. Die Reihenfolge der Platzhalter des + Formatstrings entspricht nicht mehr der Reihenfolge der Argumente im + Code. Wir würden gerne den Code belassen wie er ist, und einfach im + Formatstring angeben, welchen Argumenten die Platzhalter entsprechen. + Wir würden dann den Formatstring wie folt schreiben: + <example> + <title>Argumente tauschen</title> + <programlisting role="php"> +<![CDATA[ +$format = "The %2\$s contains %1\$d monkeys"; +printf($format,$num,$location); +]]> + </programlisting> + </example> + Ein weiterer Vorteil ist, dass wir nun die Platzhalter wiederholen + können, ohne mehr Argumente im Code hinzufügen zu müssen. Zum Beispiel: + <example> + <title>Argumente tauschen</title> + <programlisting role="php"> +<![CDATA[ +$format = "The %2\$s contains %1\$d monkeys. + That's a nice %2\$s full of %1\$d monkeys."; +printf($format, $num, $location); +]]> + </programlisting> + </example> + </para> <simpara> Siehe auch: <function>printf</function>, <function>sscanf</function>, <function>fscanf</function> und @@ -128,33 +182,24 @@ <title>Beispiele:</title> <para> <example> - <title> - <function>sprintf</function>: Null-gefüllte Integer-Werte - </title> + <title><function>sprintf</function>: Null-gefüllte Integer-Werte</title> <programlisting role="php"> +<![CDATA[ $isodatum = sprintf ("%04d-%02d-%02d", $jahr, $monat, $tag); +]]> </programlisting> </example> <example> - <title> - <function>sprintf</function>: Integer- zu Binärwert - </title> - <programlisting role="php"> -$wert = 155; -$binaer = sprintf ("%b", $wert); -echo ("<br> $binaer <br>"); -// gibt 10011011 aus - </programlisting> - </example> - <example> - <title><function>sprintf</function>: Währungsformatierung</title> + <title><function>sprintf</function>: Währung formatieren</title> <programlisting role="php"> +<![CDATA[ $money1 = 68.75; $money2 = 54.35; $money = $money1 + $money2; -// echo $money wird "123.1" ausgeben -$formatiert = sprintf ("%01.2f", $money); -// echo $formatiert wird "123.10" ausgeben +// echo $money wird ausgeben "123.1"; +$formatted = sprintf("%01.2f", $money); +// echo $formatted wird ausgeben "123.10" +]]> </programlisting> </example> </para> Index: phpdoc-de/reference/strings/functions/sscanf.xml diff -u phpdoc-de/reference/strings/functions/sscanf.xml:1.3 phpdoc-de/reference/strings/functions/sscanf.xml:1.4 --- phpdoc-de/reference/strings/functions/sscanf.xml:1.3 Sun Jun 9 06:56:16 2002 +++ phpdoc-de/reference/strings/functions/sscanf.xml Wed Jan 22 17:02:13 2003 @@ -1,14 +1,12 @@ <?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 'sscanf' in en/ tree in rev 1.33 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.33 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.sscanf"> <refnamediv> <refname>sscanf</refname> <refpurpose> - Übertragt die Eingaben eines Strings in ein angegebenes Format + Überträgt einen String in ein angegebenes Format </refpurpose> </refnamediv> <refsect1> @@ -22,19 +20,29 @@ <para> Die Funktion <function>sscanf</function> ist die Eingabe analog zu <function>printf</function>. <function>sscanf</function> liest den - <parameter>str</parameter>-String und interpretiert ihn Anlehnung - an die angegebenen <parameter>format</parameter> Parameter. Werden + String <parameter>str</parameter> und interpretiert ihn entsprechend + dem angegebenen Parameter <parameter>format</parameter>. Werden nur 2 Parameter angegeben, werden die analysierten Werte als Array - zurück gegeben. + zurückgegeben. + </para> + <para> + Irgendwelche Whitespaces in dem Formatstring entsprechen auch irgendwelchen + Whitespaces in dem übergebenen String. Das heißt, dass auch ein Tabulator + \t im Formatstring einem einzelnen Leerzeichen des übergebenen Strings + entsprechen kann. + </para> + <para> <example> <title><function>sscanf</function>-Beispiel:</title> <programlisting role="php"> +<![CDATA[ // Ermittlung der Serien-Nr. $serial = sscanf("SN/2350001","SN/%d"); // und des Herstellungsdatums $mandate = "Januar 01 2000"; 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 @@ -42,16 +50,17 @@ refenziert übergeben werden. <example> <title> - <function>sscanf</function> - Gebrauch optionaler Parameter - </title> + <function>sscanf</function> - Gebrauch optionaler Parameter</title> <programlisting role="php"> +<![CDATA[ // Ermittlung der Autoren-Info und Erzeugung eines DocBook-Eintrages $auth = "24\tLewis Carroll"; -$n = sscanf($auth,"%d\t%s %s", &$id, &$first, &$last); -echo "<author id='$id'> - <firstname>$first</firstname> - <surname>$last</surname> - </author>\n"; +$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> Index: phpdoc-de/reference/strings/functions/str-repeat.xml diff -u phpdoc-de/reference/strings/functions/str-repeat.xml:1.3 phpdoc-de/reference/strings/functions/str-repeat.xml:1.4 --- phpdoc-de/reference/strings/functions/str-repeat.xml:1.3 Sun Jun 9 06:56:16 2002 +++ phpdoc-de/reference/strings/functions/str-repeat.xml Wed Jan 22 17:02:13 2003 @@ -1,13 +1,11 @@ <?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 'str-repeat' 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.5 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.str-repeat"> <refnamediv> <refname>str_repeat</refname> - <refpurpose>Wiederholung eine String-Ausgabe</refpurpose> + <refpurpose>Wiederholt eine String-Ausgabe</refpurpose> </refnamediv> <refsect1> <title>Beschreibung:</title> @@ -17,24 +15,26 @@ <methodparam><type>int</type><parameter>multiplier</parameter></methodparam> </methodsynopsis> <para> - Die Ausgabe von <parameter>input_str</parameter> wird - <parameter>multiplier</parameter> mal wiederholt. - <parameter>Multiplier</parameter> muss grösser als 0 sein. + Gibt <parameter>input_str</parameter> <parameter>multiplier</parameter> + mal zurück, wobei <parameter>multiplier</parameter> größer als 0 sein + muss. </para> <example> <title><function>str_repeat</function>-Beispiel:</title> <programlisting role="php"> +<![CDATA[ echo str_repeat ("-=", 10); +]]> </programlisting> </example> <para> Es wird "-=-=-=-=-=-=-=-=-=-=" ausgegeben. </para> - <note> - <para> - Verfügbar ab PHP 4.0. - </para> - </note> + <para> + Siehe auch <link linkend="control-structures.for">for</link>, + <function>str_pad</function> und + <function>substr_count</function>. + </para> </refsect1> </refentry> Index: phpdoc-de/reference/strings/functions/strnatcmp.xml diff -u phpdoc-de/reference/strings/functions/strnatcmp.xml:1.3 phpdoc-de/reference/strings/functions/strnatcmp.xml:1.4 --- phpdoc-de/reference/strings/functions/strnatcmp.xml:1.3 Sun Jun 9 06:56:17 2002 +++ phpdoc-de/reference/strings/functions/strnatcmp.xml Wed Jan 22 17:02:13 2003 @@ -1,9 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.23 --> -<!-- last change to 'strnatcmp' in en/ tree in rev 1.38 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.38 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.strnatcmp"> <refnamediv> <refname>strnatcmp</refname> @@ -19,46 +17,50 @@ <methodparam><type>string</type><parameter>str2</parameter></methodparam> </methodsynopsis> <para> - Diese Funktion implemetiert einen Vergleich, der alphanumerische - Zeichen "menschlich" einordnet (auch "natürliche Ordnung" - genannt). Der Unterschied zwischen dieser und der regulären - String-Sortierung eines Computer (unter Verwendung von + Diese Funktion implemetiert einen Vergleichsalgorithmus, der + alphanumerische Zeichenketten "menschlich" ordnet (auch "natürliche + Ordnung" genannt). Der Unterschied zwischen dieser und der regulären + String-Sortierung eines Computers (verwendet in <function>strcmp</function>) wird in dem folgenden Beispiel gezeigt: <informalexample> - <programlisting> -$arr1 = $arr2 = array ("img12.png","img10.png","img2.png","img1.png"); + <programlisting role="php"> +<![CDATA[ +$arr1 = $arr2 = array("img12.png","img10.png","img2.png","img1.png"); echo "Normaler String-Vergleich\n"; usort($arr1,"strcmp"); print_r($arr1); echo "\nVergleich mittels natürlicher Ordnung\n"; usort($arr2,"strnatcmp"); print_r($arr2); +]]> </programlisting> </informalexample> Der o.a. Code erzeugt die folgende Ausgabe: <informalexample> - <programlisting> + <screen> +<![CDATA[ Normaler String-Vergleich Array ( - [0] => img1.png - [1] => img10.png - [2] => img12.png - [3] => img2.png + [0] => img1.png + [1] => img10.png + [2] => img12.png + [3] => img2.png ) Vergleich mittels natürlicher Ordnung Array ( - [0] => img1.png - [1] => img2.png - [2] => img10.png - [3] => img12.png + [0] => img1.png + [1] => img2.png + [2] => img10.png + [3] => img12.png ) - </programlisting> +]]> + </screen> </informalexample> - Für weitere Infos siehe Martin Pool's <ulink + Weitere Informationen finden Sie auf Martin Pool's <ulink url="&url.strnatcmp;">Natural Order String Comparison</ulink> Seite. </para> @@ -76,9 +78,9 @@ Siehe auch <function>ereg</function>, <function>strcasecmp</function>, <function>substr</function>, <function>stristr</function>, <function>strcmp</function>, - <function>strncmp</function>, <function>strnatcasecmp</function>, - <function>strstr</function>, <function>natsort</function> und - <function>natcasesort</function> . + <function>strncmp</function>, <function>strncasecmp</function>, + <function>strnatcasecmp</function>, <function>strstr</function>, + <function>natsort</function> und <function>natcasesort</function>. </simpara> </refsect1> </refentry> Index: phpdoc-de/reference/strings/functions/substr-count.xml diff -u phpdoc-de/reference/strings/functions/substr-count.xml:1.3 phpdoc-de/reference/strings/functions/substr-count.xml:1.4 --- phpdoc-de/reference/strings/functions/substr-count.xml:1.3 Sun Jun 9 06:56:17 2002 +++ phpdoc-de/reference/strings/functions/substr-count.xml Wed Jan 22 17:02:13 2003 @@ -1,40 +1,45 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.20 --> -<!-- last change to 'substr-count' in en/ tree in rev 1.27 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.27 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.substr-count"> <refnamediv> <refname>substr_count</refname> <refpurpose> - Ermittelt die Häufigkeit des Vorkommens einer Zeichenkette in - einem String + Ermittelt, wie oft eine Zeichenkette in einem String vorkommt </refpurpose> </refnamediv> <refsect1> <title>Beschreibung:</title> <methodsynopsis> <type>int</type><methodname>substr_count</methodname> - <methodparam><type>string</type><parameter>haystrack</parameter></methodparam> + <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>string</type><parameter>needle</parameter></methodparam> </methodsynopsis> <para> Die Funktion <function>substr_count</function> ermittelt, wie oft <parameter>needle</parameter> in dem String - <parameter>haystack</parameter> vorkommt. + <parameter>haystack</parameter> vorkommt, und gibt die Anzahl der + Vorkommen zurück. </para> + <para> <example> <title><function>substr_count</function>-Beispiel:</title> - <programlisting> + <programlisting role="php"> +<![CDATA[ +<?php print substr_count("Dieser Test ist Mist", "ist"); // ergibt 2 +?> +]]> </programlisting> </example> </para> - <para> - Diese Funktion steht ab PHP 4.0.0 zur Verfügung. - </para> + <simpara> + Siehe auch <function>count_chars</function>, + <function>strpos</function>, <function>substr</function> + und <function>strstr</function>. + </simpara> </refsect1> </refentry> Index: phpdoc-de/reference/strings/functions/substr.xml diff -u phpdoc-de/reference/strings/functions/substr.xml:1.3 phpdoc-de/reference/strings/functions/substr.xml:1.4 --- phpdoc-de/reference/strings/functions/substr.xml:1.3 Sun Jun 9 06:56:17 2002 +++ phpdoc-de/reference/strings/functions/substr.xml Wed Jan 22 17:02:13 2003 @@ -1,13 +1,11 @@ <?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 'substr' 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.6 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.substr"> <refnamediv> <refname>substr</refname> - <refpurpose>Gibt einen Teilstring zurück</refpurpose> + <refpurpose>Gibt einen Teil eines Strings zurück</refpurpose> </refnamediv> <refsect1> <title>Beschreibung:</title> @@ -18,10 +16,10 @@ <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> </methodsynopsis> <para> - <function>substr</function> gibt den Teil von - <parameter>string</parameter> zurück, der durch die + <function>substr</function> gibt den Teil von + <parameter>string</parameter> zurück, der durch die Parameter <parameter>start</parameter> und <parameter>length</parameter> - Parameter definiert wurde. + definiert wurde. </para> <para> Wenn <parameter>start</parameter> positiv ist, beginnt der zurück @@ -31,36 +29,71 @@ <literal>0</literal> gleich '<literal>a</literal>', das Zeichen an der Position <literal>2</literal> ist '<literal>c</literal>' usw. </para> + <example> + <title>Generelle Verwendung von <function>substr</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +$rest = substr("abcdef", 1); // gibt "bcdef" zurück +$rest = substr("abcdef", 1, 3); // gibt "bcd" zurück +$rest = substr("abcdef", 0, 4); // gibt "abcd" zurück +$rest = substr("abcdef", 0, 8); // gibt "abcdef" zurück + +// Der Zugriff mittels geschwungenen Klammer ist eine +// weitere Möglickeit +$string = 'abcdef'; +echo $string{0}; // gibt a zurück +echo $string{3}; // gibt d zurück +?> +]]> + </programlisting> + </example> <para> - Beispiele: - <informalexample> - <programlisting role="php"> -$rest = substr ("abcdef", 1); // gibt "bcdef" zurück -$rest = substr ("abcdef", 1, 3); // gibt "bcd" zurück - </programlisting> - </informalexample> + Ist <parameter>start</parameter> negativ, beginnt der zurückgegebene + String bei dem <parameter>start</parameter>'en Zeichen vom Ende von + <parameter>string</parameter>. </para> + <example> + <title>Negativen <parameter>start</parameter> verwenden</title> + <programlisting role="php"> +<![CDATA[ +<?php +$rest = substr("abcdef", -1); // gibt "f" zurück +$rest = substr("abcdef", -2); // gibt "ef" zurück +$rest = substr("abcdef", -3, 1); // gibt "d" zurück +?> +]]> + </programlisting> + </example> <para> - Ist <parameter>start</parameter> negativ, gibt er den Beginn-Wert - ab Ende des Strings an (also rückwärts gezählt). - </para> + Ist <parameter>length</parameter> angegeben und positiv, enthält der + zurückgegebene String höchstens <parameter>length</parameter> Zeichen + ab <parameter>start</parameter> (abhängig von der Länge von + <parameter>string</parameter>). Ist <parameter>string</parameter> + kürzer als <parameter>start</parameter> Zeichen, wird &false; + zurückgegeben. + </para> <para> - Beispiele: - <informalexample> - <programlisting role="php"> -$rest = substr ("abcdef", -1); // gibt "f" zurück -$rest = substr ("abcdef", -2); // gibt "ef" zurück -$rest = substr ("abcdef", -3, 1); // gibt "d" zurück -$rest = substr ("abcdef", 1, -1); // gibt "bcde" zurück -$rest = substr ("abcdef", 4, -4); // gibt "" zurück (nichts) -$rest = substr ("abcdef", 7, 1); // gibt "" zurück (nichts) -$rest = substr ("abcdef", 7, -4); // gibt "" zurück (nichts) -$rest = substr ("abcdef", 4, 4); // gibt "ef" zurück -$rest = substr ("abcdef", -2, 4); // gibt "ef" zurück -$rest = substr ("abcdef", -5, -4); // gibt "b" zurück - </programlisting> - </informalexample> + Ist <parameter>length</parameter> angegeben und negativ, dann werden + genauso viele Zeichen vom Ende von <parameter>string</parameter> + abgeschnitten (nachdem die Starposition ermittelt wurde, sollte + <parameter>start</parameter> negativ sein). Gibt + <parameter>start</parameter> eine Position hinter dem abzuschneidenden + Teil an, wird ein leerer String zurückgegeben. </para> + <example> + <title>Negative <parameter>length</parameter> verwenden</title> + <programlisting role="php"> +<![CDATA[ +<?php +$rest = substr("abcdef", 0, -1); // gibt "abcde" zurück +$rest = substr("abcdef", 2, -1); // gibt "cde" zurück +$rest = substr("abcdef", 4, -4); // gibt "" zurück +$rest = substr("abcdef", -3, -1); // gibt "de" zurück +?> +]]> + </programlisting> + </example> <para> Siehe auch <function>strrchr</function> und <function>ereg</function>. Index: phpdoc-de/reference/strings/functions/wordwrap.xml diff -u phpdoc-de/reference/strings/functions/wordwrap.xml:1.2 phpdoc-de/reference/strings/functions/wordwrap.xml:1.3 --- phpdoc-de/reference/strings/functions/wordwrap.xml:1.2 Sun Jun 9 06:56:17 2002 +++ phpdoc-de/reference/strings/functions/wordwrap.xml Wed Jan 22 17:02:13 2003 @@ -1,15 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> -<!-- last change to 'wordwrap' in en/ tree in rev 1.142 --> -<!-- EN-Revision: 0.0 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.142 --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.wordwrap"> <refnamediv> <refname>wordwrap</refname> <refpurpose> - Zeilenumbruch eines Strings an einer angegebenen Stelle unter - Verwendung eines angegebenen Trennzeichens + Bricht die Zeilen eines Strings nach einer bestimmten Anzahl + Zeichen mittels des angegebenen Trennzeichens um. </refpurpose> </refnamediv> <refsect1> @@ -22,30 +20,41 @@ <methodparam choice="opt"><type>int</type><parameter>cut</parameter></methodparam> </methodsynopsis> <para> - Bricht den String <parameter>str</parameter> an der mittels - <parameter>width</parameter> angegebenen - Position in die nächste Zeile um. Der Umbruch geschieht mit - dem <parameter>break</parameter> Parameter. + Bricht die Zeilen des Strings <parameter>str</parameter> an der + mittels <parameter>width</parameter> angegebenen Position um. + Diese Zeilenumbrüche werden mit dem im (optionalen) Parameter + <parameter>break</parameter> spezifizierten Steuerzeichen + durchgeführt. </para> <para> - Die Funktion <function>wordwrap</function> bricht selbst an der - Spalte 75 unter Verwendung des Steuerzeichens '\n' (neue Zeile) - um, wenn die optionalen Parameter <parameter>width</parameter> - und / oder <parameter>break</parameter> nicht angegeben werden. + Die Funktion <function>wordwrap</function> bricht die Zeilen + automatisch an der Spalte 75 unter Verwendung des Steuerzeichens + '\n' (neue Zeile) um, wenn die optionalen Parameter + <parameter>width</parameter> und / oder <parameter>break</parameter> + nicht angegeben sind. </para> <para> Steht <parameter>cut</parameter> auf 1, wird der String immer an der vorgegebenen Länge umgebrochen. Ist ein Wort also länger als - die gegebene Länge, wird es mitten drin umgebrochen (siehe zweites - Beispiel) + die gegebene Länge, wird der Zeilumbruch auch innerhalb des Wortes + eingefügt (siehe zweites Beispiel). + <note> + <para> + Der optionale Parameter <parameter>cut</parameter> wurde in PHP 4.0.3 + eingeführt. + </para> + </note> </para> <para> <example> <title><function>wordwrap</function>-Beispiel:</title> <programlisting role="php"> -$text = "Der schnelle braune Fuchs springt über den blöden Hund."; +<![CDATA[ +$text = "Der schnelle braune Fuchs sprang über den faulen Hund."; $neuertext = wordwrap( $text, 20 ); + echo "$neuertext\n"; +]]> </programlisting> </example> </para> @@ -54,19 +63,25 @@ </para> <para> <informalexample> - <programlisting> + <screen> +<![CDATA[ Der schnelle braune -Fuchs springt über den blöden Hund. - </programlisting> +Fuchs sprang über +den faulen Hund. +]]> + </screen> </informalexample> </para> <para> <example> <title><function>wordwrap</function> example</title> <programlisting role="php"> +<![CDATA[ $text = "Ein sehr langes Wooooooooooort."; $neuertext = wordwrap( $text, 8, "\n", 1); + echo "$neuertext\n"; +]]> </programlisting> </example> </para> @@ -75,12 +90,14 @@ </para> <para> <informalexample> - <programlisting> + <screen> +<![CDATA[ Ein sehr -langes W -oooooooo -ooort. - </programlisting> +langes +Wooooooo +oooort. +]]> + </screen> </informalexample> </para> <para>