cvs: phpdoc-de /reference/array/functions array-merge.xml array-shift.xml array-splice.xml array-unshift.xml each.xml extract.xml in-array.xml
list.xml natsort.xml usort.xml
| From: | Thomas Schoefbeck | Date: | Sun, 06 Oct 2002 20:40:52 +0000 |
| Subject: | cvs: phpdoc-de /reference/array/functions array-merge.xml array-shift.xml array-splice.xml array-unshift.xml each.xml extract.xml in-array.xml list.xml natsort.xml usort.xml |
||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-281@lists.php.net to get a copy of this message | ||
tom Sun Oct 6 16:40:52 2002 EDT
Modified files:
/phpdoc-de/reference/array/functions array-merge.xml
array-shift.xml
array-splice.xml
array-unshift.xml each.xml
extract.xml in-array.xml
list.xml natsort.xml usort.xml
Log:
sync to en
Index: phpdoc-de/reference/array/functions/array-merge.xml diff -u phpdoc-de/reference/array/functions/array-merge.xml:1.4 phpdoc-de/reference/array/functions/array-merge.xml:1.5 --- phpdoc-de/reference/array/functions/array-merge.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/array-merge.xml Sun Oct 6 16:40:51 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.6 Maintainer: tom Status: ready --> <refentry id="function.array-merge"> <refnamediv> <refname>array_merge</refname> @@ -24,8 +24,8 @@ Haben die angegebenen Arrays die selben String-Schlüssel, dann wird der hintere Wert dieses Schlüssels den vorhergehenden überschreiben. Haben die Arrays den gleichen numerischen - Schlüssel, dann wird der hintere Wert den vorhergehenden nicht - überschreiben, sondern an den vorderen angehängt. + Schlüssel, dann wird der hintere Wert den vorhergehenden <emphasis + role="strong">nicht</emphasis> überschreiben, sondern angehängt. </para> <para> <example> @@ -56,6 +56,55 @@ </para> </example> </para> + <para> + <example> + <title>Einfaches <function>array_merge</function> Beispiel</title> + <programlisting role="php"> +<![CDATA[ +$array1 = array(); +$array2 = array(1 => "data"); +$result = array_merge($array1, $array2); +]]> + </programlisting> + <para> + Vergessen Sie nicht, dass numerische Schlüssel neu numeriert werden! + <screen role="php"> +<![CDATA[ +Array +( + [0] => data +) +]]> + </screen> + </para> + <para> + Wenn Sie die Arrays komplett erhalten und nur eines an das andere + anhängen wollen, verwenden Sie den Operator <literal>+</literal>: + <programlisting role="php"> +<![CDATA[ +$array1 = array(); +$array2 = array(1 => "data"); +$result = $array1 + $array2; +]]> + </programlisting> + Der numerische Schlüssel sowie die Assoziation bleiben erhalten. + <screen role="php"> +<![CDATA[ +Array +( + [1] => data +) +]]> + </screen> + </para> + </example> + </para> + <note> + <para> + Gemeinsame Schlüssel werden nach dem Prinzip "Wer zuerst kommt mahlt + zuerst" behandelt. + </para> + </note> <para> Siehe auch <function>array_merge_recursive</function>. </para> Index: phpdoc-de/reference/array/functions/array-shift.xml diff -u phpdoc-de/reference/array/functions/array-shift.xml:1.4 phpdoc-de/reference/array/functions/array-shift.xml:1.5 --- phpdoc-de/reference/array/functions/array-shift.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/array-shift.xml Sun Oct 6 16:40:51 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> <refentry id="function.array-shift"> <refnamediv> <refname>array_shift</refname> @@ -18,7 +18,9 @@ <function>array_shift</function> liefert den ersten Wert von <parameter>array</parameter>, verschiebt die anderen Werte hinunter, und verkürzt <parameter>array</parameter> um ein - Element. Ist <parameter>array</parameter> leer (oder kein + Element. Alle numerischen Schlüssel werden so modifiziert, dass + bei null zu zählen begonnen wird. Strings als Schlüssel bleiben + unverändert. Ist <parameter>array</parameter> leer (oder kein Array), wird &null; zurückgegeben. </para> <para> Index: phpdoc-de/reference/array/functions/array-splice.xml diff -u phpdoc-de/reference/array/functions/array-splice.xml:1.4 phpdoc-de/reference/array/functions/array-splice.xml:1.5 --- phpdoc-de/reference/array/functions/array-splice.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/array-splice.xml Sun Oct 6 16:40:51 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> <refentry id="function.array-splice"> <refnamediv> <refname>array_splice</refname> @@ -69,7 +69,7 @@ array_pop ($input) array_splice ($input, -1) array_shift ($input) array_splice ($input, 0, 1) array_unshift ($input, $x, $y) array_splice ($input, 0, 0, array ($x, $y)) -$a[$x] = $y array_splice ($input, $x, 1, $y) +$input[$x] = $y array_splice ($input, $x, 1, $y) ]]> </programlisting> </para> Index: phpdoc-de/reference/array/functions/array-unshift.xml diff -u phpdoc-de/reference/array/functions/array-unshift.xml:1.4 phpdoc-de/reference/array/functions/array-unshift.xml:1.5 --- phpdoc-de/reference/array/functions/array-unshift.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/array-unshift.xml Sun Oct 6 16:40:51 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> <refentry id="function.array-unshift"> <refnamediv> <refname>array_unshift</refname> @@ -22,7 +22,9 @@ <function>array_unshift</function> fügt die übergebenen Elemente am Anfang von <parameter>array</parameter> ein. Beachten Sie, dass die Liste von Elementen als Ganzes eingefügt wird, sodass - die eingefügten Elemente die selbe Reihenfolge haben. + die eingefügten Elemente die selbe Reihenfolge haben. Die + numerischen Schlüssel werden so modifiziert, dass bei null zu + zählen begonnen wird, Strings als Schlüssel bleiben unverändert. </para> <para> Diese Funktion gibt die neue Anzahl der in Index: phpdoc-de/reference/array/functions/each.xml diff -u phpdoc-de/reference/array/functions/each.xml:1.5 phpdoc-de/reference/array/functions/each.xml:1.6 --- phpdoc-de/reference/array/functions/each.xml:1.5 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/each.xml Sun Oct 6 16:40:51 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.6 Maintainer: tom Status: ready --> <refentry id="function.each"> <refnamediv> <refname>each</refname> @@ -69,18 +69,18 @@ <para> <function>each</function> wird typischerweise in Verbindung mit <function>list</function> verwendet, um ein Array durchzugehen; - zum Beispiel <varname>$HTTP_POST_VARS</varname>: + zum Beispiel <varname>$_POST</varname>: <example> <title> - Durchgehen aller <varname>$HTTP_POST_VARS</varname> mit + Durchgehen von <varname>$_POST</varname> mit <function>each</function> </title> <programlisting role="php"> <![CDATA[ -echo "Werte, die mit der POST Methode übertragen wurden:<br>"; -reset ($HTTP_POST_VARS); -while (list ($key, $val) = each ($HTTP_POST_VARS)) { - echo "$key => $val<br>"; +echo "Werte, die mit der POST Methode übertragen wurden:<br />"; +reset ($_POST); +while (list ($key, $val) = each ($_POST)) { + echo "$key => $val<br />\n"; } ]]> </programlisting> Index: phpdoc-de/reference/array/functions/extract.xml diff -u phpdoc-de/reference/array/functions/extract.xml:1.5 phpdoc-de/reference/array/functions/extract.xml:1.6 --- phpdoc-de/reference/array/functions/extract.xml:1.5 Wed Jul 17 04:52:05 2002 +++ phpdoc-de/reference/array/functions/extract.xml Sun Oct 6 16:40:51 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.6 Maintainer: tom Status: ready --> <refentry id="function.extract"> <refnamediv> <refname>extract</refname> @@ -38,6 +38,11 @@ eingeführt. </para> </note> + <note> + <para> + EXTR_REFS wurde in Version 4.3.0 eingeführt. + </para> + </note> <para> <function>extract</function> prüft jeden Schlüssel, ob dieser einen gültigen Variablennamen ergibt, und auch auf eventuelle @@ -78,7 +83,7 @@ <simpara> Allen Variablennamen wird <parameter>prefix</parameter> vorangestellt. Seit PHP 4.0.5 gilt dies auch für numerische - Schlüssel. + Variablen. </simpara> </listitem> </varlistentry> @@ -112,6 +117,19 @@ Erstellt nur Variablennamen mit Präfix, wenn die Version ohne Präfix der selben Variable in der aktuellen Symboltabelle existiert. Dieser Flag wurde in PHP 4.2.0 eingeführt. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>EXTR_REFS</term> + <listitem> + <simpara> + Extrahiert Variablen als Referenzen. Das heißt, dass die Werte der + importierten Variablen noch immer auf die Werte des Parameters + <parameter>var_array</parameter> referenzieren. Sie können diesen + Flag alleine oder auch in Kombination mit einem anderen Flag verwenden, + indem Sie Oder-Verknüpfungen im <parameter>extract_type</parameter> + erstellen. Dieser Flag wurde in PHP 4.3.0 eingeführt. </simpara> </listitem> </varlistentry> Index: phpdoc-de/reference/array/functions/in-array.xml diff -u phpdoc-de/reference/array/functions/in-array.xml:1.4 phpdoc-de/reference/array/functions/in-array.xml:1.5 --- phpdoc-de/reference/array/functions/in-array.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/in-array.xml Sun Oct 6 16:40:51 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> <refentry id="function.in-array"> <refnamediv> <refname>in_array</refname> Index: phpdoc-de/reference/array/functions/list.xml diff -u phpdoc-de/reference/array/functions/list.xml:1.4 phpdoc-de/reference/array/functions/list.xml:1.5 --- phpdoc-de/reference/array/functions/list.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/list.xml Sun Oct 6 16:40:51 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.7 Maintainer: tom Status: ready --> <refentry id="function.list"> <refnamediv> <refname>list</refname> @@ -79,6 +79,47 @@ ]]> </programlisting> </example> + </para> + <warning> + <para> + <function>list</function> weist die Werte von rechts beginnend zu. + Wenn Sie einfache Variablen benutzen, brauchen Sie sich nicht darum + zu kümmern. Wenn Sie jedoch Arrays mit Indizes verwenden, erwarten Sie + gewöhnlich die Reihenfolge der Indizes in dem Array genau so, wie Sie + sie in <function>list</function> geschrieben haben (von links nach + rechts), was jedoch nicht der Fall ist. Es wird in der umgekehrten + Reihenfolge zugewiesen. + </para> + </warning> + <para> + <example> + <title><function>list</function> mit Array Indizes verwenden</title> + <programlisting role="php"> +<![CDATA[ +<?php + +$info = array('coffee', 'brown', 'caffeine'); + +list($a[0], $a[1], $a[2]) = $info; + +var_dump($a); + +?> +]]> + </programlisting> + </example> + Die Ausgabe (Beachten Sie die Reihenfolge der Elemente, verglichen mit + der in <function>list</function> eingetragenen Reihenfolge): + <screen> +array(3) { + [2]=> + string(8) "caffeine" + [1]=> + string(5) "brown" + [0]=> + string(6) "coffee" +} + </screen> </para> <para> Siehe auch <function>each</function>, <function>array</function> Index: phpdoc-de/reference/array/functions/natsort.xml diff -u phpdoc-de/reference/array/functions/natsort.xml:1.4 phpdoc-de/reference/array/functions/natsort.xml:1.5 --- phpdoc-de/reference/array/functions/natsort.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/natsort.xml Sun Oct 6 16:40:51 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> <refentry id="function.natsort"> <refnamediv> <refname>natsort</refname> @@ -26,6 +26,7 @@ <title><function>natsort</function></title> <programlisting role="php"> <![CDATA[ +<?php $array1 = $array2 = array ("img12.png", "img10.png", "img2.png", "img1.png"); sort ($array1); echo "Standardsortierung\n"; @@ -34,6 +35,7 @@ natsort ($array2); echo "\nSortieren mit natürlicher Reihenfolge\n"; print_r ($array2); +?> ]]> </programlisting> </example> @@ -67,6 +69,12 @@ url="&url.strnatcmp;">Natural Order String Comparison</ulink> Seite. </para> + <note> + <para> + Wenn Sie die Index/Wert Assoziationen beibehalten wollen, denken Sie + an die Verwendung von <literal>usort($arr, 'strnatcmp')</literal>. + </para> + </note> <para> Siehe auch <function>natcasesort</function>, <function>strnatcmp</function> und Index: phpdoc-de/reference/array/functions/usort.xml diff -u phpdoc-de/reference/array/functions/usort.xml:1.4 phpdoc-de/reference/array/functions/usort.xml:1.5 --- phpdoc-de/reference/array/functions/usort.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/usort.xml Sun Oct 6 16:40:51 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.6 Maintainer: tom Status: ready --> <refentry id="function.usort"> <refnamediv> <refname>usort</refname> @@ -26,8 +26,16 @@ Die Vergleichsfunktion muss einen Integer zurückgeben, der kleiner, gleich, oder größer ist als &null;, wenn für das erste Argument auch angenommen wird, dass es kleiner, gleich, oder - größer ist als das zweite. Sind zwei Elemente gleich, ist deren - Reihenfolge nicht definiert. + größer ist als das zweite. + <note> + <para> + Sind zwei Elemente gleich, ist deren Reihenfolge nicht definiert. Bis zu + PHP 4.0.6 würde die benutzerdefinierte Funktion die originäre Reihenfolge + beibehalten, doch seit der Einführung des neuen Sortieralgorhythmus mit + 4.1.0 ist dies nicht mehr der Fall, da es keine effiziente Lösung dafür + gibt. + </para> + </note> </para> <para> <example>
Index: phpdoc-de/reference/array/functions/array-merge.xml diff -u phpdoc-de/reference/array/functions/array-merge.xml:1.4 phpdoc-de/reference/array/functions/array-merge.xml:1.5 --- phpdoc-de/reference/array/functions/array-merge.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/array-merge.xml Sun Oct 6 16:40:51 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.6 Maintainer: tom Status: ready --> <refentry id="function.array-merge"> <refnamediv> <refname>array_merge</refname> @@ -24,8 +24,8 @@ Haben die angegebenen Arrays die selben String-Schlüssel, dann wird der hintere Wert dieses Schlüssels den vorhergehenden überschreiben. Haben die Arrays den gleichen numerischen - Schlüssel, dann wird der hintere Wert den vorhergehenden nicht - überschreiben, sondern an den vorderen angehängt. + Schlüssel, dann wird der hintere Wert den vorhergehenden <emphasis + role="strong">nicht</emphasis> überschreiben, sondern angehängt. </para> <para> <example> @@ -56,6 +56,55 @@ </para> </example> </para> + <para> + <example> + <title>Einfaches <function>array_merge</function> Beispiel</title> + <programlisting role="php"> +<![CDATA[ +$array1 = array(); +$array2 = array(1 => "data"); +$result = array_merge($array1, $array2); +]]> + </programlisting> + <para> + Vergessen Sie nicht, dass numerische Schlüssel neu numeriert werden! + <screen role="php"> +<![CDATA[ +Array +( + [0] => data +) +]]> + </screen> + </para> + <para> + Wenn Sie die Arrays komplett erhalten und nur eines an das andere + anhängen wollen, verwenden Sie den Operator <literal>+</literal>: + <programlisting role="php"> +<![CDATA[ +$array1 = array(); +$array2 = array(1 => "data"); +$result = $array1 + $array2; +]]> + </programlisting> + Der numerische Schlüssel sowie die Assoziation bleiben erhalten. + <screen role="php"> +<![CDATA[ +Array +( + [1] => data +) +]]> + </screen> + </para> + </example> + </para> + <note> + <para> + Gemeinsame Schlüssel werden nach dem Prinzip "Wer zuerst kommt mahlt + zuerst" behandelt. + </para> + </note> <para> Siehe auch <function>array_merge_recursive</function>. </para> Index: phpdoc-de/reference/array/functions/array-shift.xml diff -u phpdoc-de/reference/array/functions/array-shift.xml:1.4 phpdoc-de/reference/array/functions/array-shift.xml:1.5 --- phpdoc-de/reference/array/functions/array-shift.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/array-shift.xml Sun Oct 6 16:40:51 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> <refentry id="function.array-shift"> <refnamediv> <refname>array_shift</refname> @@ -18,7 +18,9 @@ <function>array_shift</function> liefert den ersten Wert von <parameter>array</parameter>, verschiebt die anderen Werte hinunter, und verkürzt <parameter>array</parameter> um ein - Element. Ist <parameter>array</parameter> leer (oder kein + Element. Alle numerischen Schlüssel werden so modifiziert, dass + bei null zu zählen begonnen wird. Strings als Schlüssel bleiben + unverändert. Ist <parameter>array</parameter> leer (oder kein Array), wird &null; zurückgegeben. </para> <para> Index: phpdoc-de/reference/array/functions/array-splice.xml diff -u phpdoc-de/reference/array/functions/array-splice.xml:1.4 phpdoc-de/reference/array/functions/array-splice.xml:1.5 --- phpdoc-de/reference/array/functions/array-splice.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/array-splice.xml Sun Oct 6 16:40:51 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> <refentry id="function.array-splice"> <refnamediv> <refname>array_splice</refname> @@ -69,7 +69,7 @@ array_pop ($input) array_splice ($input, -1) array_shift ($input) array_splice ($input, 0, 1) array_unshift ($input, $x, $y) array_splice ($input, 0, 0, array ($x, $y)) -$a[$x] = $y array_splice ($input, $x, 1, $y) +$input[$x] = $y array_splice ($input, $x, 1, $y) ]]> </programlisting> </para> Index: phpdoc-de/reference/array/functions/array-unshift.xml diff -u phpdoc-de/reference/array/functions/array-unshift.xml:1.4 phpdoc-de/reference/array/functions/array-unshift.xml:1.5 --- phpdoc-de/reference/array/functions/array-unshift.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/array-unshift.xml Sun Oct 6 16:40:51 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> <refentry id="function.array-unshift"> <refnamediv> <refname>array_unshift</refname> @@ -22,7 +22,9 @@ <function>array_unshift</function> fügt die übergebenen Elemente am Anfang von <parameter>array</parameter> ein. Beachten Sie, dass die Liste von Elementen als Ganzes eingefügt wird, sodass - die eingefügten Elemente die selbe Reihenfolge haben. + die eingefügten Elemente die selbe Reihenfolge haben. Die + numerischen Schlüssel werden so modifiziert, dass bei null zu + zählen begonnen wird, Strings als Schlüssel bleiben unverändert. </para> <para> Diese Funktion gibt die neue Anzahl der in Index: phpdoc-de/reference/array/functions/each.xml diff -u phpdoc-de/reference/array/functions/each.xml:1.5 phpdoc-de/reference/array/functions/each.xml:1.6 --- phpdoc-de/reference/array/functions/each.xml:1.5 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/each.xml Sun Oct 6 16:40:51 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.6 Maintainer: tom Status: ready --> <refentry id="function.each"> <refnamediv> <refname>each</refname> @@ -69,18 +69,18 @@ <para> <function>each</function> wird typischerweise in Verbindung mit <function>list</function> verwendet, um ein Array durchzugehen; - zum Beispiel <varname>$HTTP_POST_VARS</varname>: + zum Beispiel <varname>$_POST</varname>: <example> <title> - Durchgehen aller <varname>$HTTP_POST_VARS</varname> mit + Durchgehen von <varname>$_POST</varname> mit <function>each</function> </title> <programlisting role="php"> <![CDATA[ -echo "Werte, die mit der POST Methode übertragen wurden:<br>"; -reset ($HTTP_POST_VARS); -while (list ($key, $val) = each ($HTTP_POST_VARS)) { - echo "$key => $val<br>"; +echo "Werte, die mit der POST Methode übertragen wurden:<br />"; +reset ($_POST); +while (list ($key, $val) = each ($_POST)) { + echo "$key => $val<br />\n"; } ]]> </programlisting> Index: phpdoc-de/reference/array/functions/extract.xml diff -u phpdoc-de/reference/array/functions/extract.xml:1.5 phpdoc-de/reference/array/functions/extract.xml:1.6 --- phpdoc-de/reference/array/functions/extract.xml:1.5 Wed Jul 17 04:52:05 2002 +++ phpdoc-de/reference/array/functions/extract.xml Sun Oct 6 16:40:51 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.6 Maintainer: tom Status: ready --> <refentry id="function.extract"> <refnamediv> <refname>extract</refname> @@ -38,6 +38,11 @@ eingeführt. </para> </note> + <note> + <para> + EXTR_REFS wurde in Version 4.3.0 eingeführt. + </para> + </note> <para> <function>extract</function> prüft jeden Schlüssel, ob dieser einen gültigen Variablennamen ergibt, und auch auf eventuelle @@ -78,7 +83,7 @@ <simpara> Allen Variablennamen wird <parameter>prefix</parameter> vorangestellt. Seit PHP 4.0.5 gilt dies auch für numerische - Schlüssel. + Variablen. </simpara> </listitem> </varlistentry> @@ -112,6 +117,19 @@ Erstellt nur Variablennamen mit Präfix, wenn die Version ohne Präfix der selben Variable in der aktuellen Symboltabelle existiert. Dieser Flag wurde in PHP 4.2.0 eingeführt. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>EXTR_REFS</term> + <listitem> + <simpara> + Extrahiert Variablen als Referenzen. Das heißt, dass die Werte der + importierten Variablen noch immer auf die Werte des Parameters + <parameter>var_array</parameter> referenzieren. Sie können diesen + Flag alleine oder auch in Kombination mit einem anderen Flag verwenden, + indem Sie Oder-Verknüpfungen im <parameter>extract_type</parameter> + erstellen. Dieser Flag wurde in PHP 4.3.0 eingeführt. </simpara> </listitem> </varlistentry> Index: phpdoc-de/reference/array/functions/in-array.xml diff -u phpdoc-de/reference/array/functions/in-array.xml:1.4 phpdoc-de/reference/array/functions/in-array.xml:1.5 --- phpdoc-de/reference/array/functions/in-array.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/in-array.xml Sun Oct 6 16:40:51 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> <refentry id="function.in-array"> <refnamediv> <refname>in_array</refname> Index: phpdoc-de/reference/array/functions/list.xml diff -u phpdoc-de/reference/array/functions/list.xml:1.4 phpdoc-de/reference/array/functions/list.xml:1.5 --- phpdoc-de/reference/array/functions/list.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/list.xml Sun Oct 6 16:40:51 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.7 Maintainer: tom Status: ready --> <refentry id="function.list"> <refnamediv> <refname>list</refname> @@ -79,6 +79,47 @@ ]]> </programlisting> </example> + </para> + <warning> + <para> + <function>list</function> weist die Werte von rechts beginnend zu. + Wenn Sie einfache Variablen benutzen, brauchen Sie sich nicht darum + zu kümmern. Wenn Sie jedoch Arrays mit Indizes verwenden, erwarten Sie + gewöhnlich die Reihenfolge der Indizes in dem Array genau so, wie Sie + sie in <function>list</function> geschrieben haben (von links nach + rechts), was jedoch nicht der Fall ist. Es wird in der umgekehrten + Reihenfolge zugewiesen. + </para> + </warning> + <para> + <example> + <title><function>list</function> mit Array Indizes verwenden</title> + <programlisting role="php"> +<![CDATA[ +<?php + +$info = array('coffee', 'brown', 'caffeine'); + +list($a[0], $a[1], $a[2]) = $info; + +var_dump($a); + +?> +]]> + </programlisting> + </example> + Die Ausgabe (Beachten Sie die Reihenfolge der Elemente, verglichen mit + der in <function>list</function> eingetragenen Reihenfolge): + <screen> +array(3) { + [2]=> + string(8) "caffeine" + [1]=> + string(5) "brown" + [0]=> + string(6) "coffee" +} + </screen> </para> <para> Siehe auch <function>each</function>, <function>array</function> Index: phpdoc-de/reference/array/functions/natsort.xml diff -u phpdoc-de/reference/array/functions/natsort.xml:1.4 phpdoc-de/reference/array/functions/natsort.xml:1.5 --- phpdoc-de/reference/array/functions/natsort.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/natsort.xml Sun Oct 6 16:40:51 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> <refentry id="function.natsort"> <refnamediv> <refname>natsort</refname> @@ -26,6 +26,7 @@ <title><function>natsort</function></title> <programlisting role="php"> <![CDATA[ +<?php $array1 = $array2 = array ("img12.png", "img10.png", "img2.png", "img1.png"); sort ($array1); echo "Standardsortierung\n"; @@ -34,6 +35,7 @@ natsort ($array2); echo "\nSortieren mit natürlicher Reihenfolge\n"; print_r ($array2); +?> ]]> </programlisting> </example> @@ -67,6 +69,12 @@ url="&url.strnatcmp;">Natural Order String Comparison</ulink> Seite. </para> + <note> + <para> + Wenn Sie die Index/Wert Assoziationen beibehalten wollen, denken Sie + an die Verwendung von <literal>usort($arr, 'strnatcmp')</literal>. + </para> + </note> <para> Siehe auch <function>natcasesort</function>, <function>strnatcmp</function> und Index: phpdoc-de/reference/array/functions/usort.xml diff -u phpdoc-de/reference/array/functions/usort.xml:1.4 phpdoc-de/reference/array/functions/usort.xml:1.5 --- phpdoc-de/reference/array/functions/usort.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/usort.xml Sun Oct 6 16:40:51 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.6 Maintainer: tom Status: ready --> <refentry id="function.usort"> <refnamediv> <refname>usort</refname> @@ -26,8 +26,16 @@ Die Vergleichsfunktion muss einen Integer zurückgeben, der kleiner, gleich, oder größer ist als &null;, wenn für das erste Argument auch angenommen wird, dass es kleiner, gleich, oder - größer ist als das zweite. Sind zwei Elemente gleich, ist deren - Reihenfolge nicht definiert. + größer ist als das zweite. + <note> + <para> + Sind zwei Elemente gleich, ist deren Reihenfolge nicht definiert. Bis zu + PHP 4.0.6 würde die benutzerdefinierte Funktion die originäre Reihenfolge + beibehalten, doch seit der Einführung des neuen Sortieralgorhythmus mit + 4.1.0 ist dies nicht mehr der Fall, da es keine effiziente Lösung dafür + gibt. + </para> + </note> </para> <para> <example>