cvs: phpdoc-de /reference/array/functions array-diff.xml array-intersect.xml array-map.xml array-reduce.xml array-walk.xml each.xml range.xml
uasort.xml uksort.xml usort.xml
| From: | Thomas Schoefbeck | Date: | Sat, 11 Jan 2003 15:19:37 +0000 |
| Subject: | cvs: phpdoc-de /reference/array/functions array-diff.xml array-intersect.xml array-map.xml array-reduce.xml array-walk.xml each.xml range.xml uasort.xml uksort.xml usort.xml |
||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-433@lists.php.net to get a copy of this message | ||
tom Sat Jan 11 10:19:37 2003 EDT
Modified files:
/phpdoc-de/reference/array/functions array-diff.xml
array-intersect.xml
array-map.xml array-reduce.xml
array-walk.xml each.xml
range.xml uasort.xml
uksort.xml usort.xml
Log:
sync to en
Index: phpdoc-de/reference/array/functions/array-diff.xml diff -u phpdoc-de/reference/array/functions/array-diff.xml:1.5 phpdoc-de/reference/array/functions/array-diff.xml:1.6 --- phpdoc-de/reference/array/functions/array-diff.xml:1.5 Sat Oct 5 18:47:01 2002 +++ phpdoc-de/reference/array/functions/array-diff.xml Sat Jan 11 10:19:37 2003 @@ -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.7 Maintainer: tom Status: ready --> <refentry id="function.array-diff"> <refnamediv> <refname>array_diff</refname> @@ -56,7 +56,9 @@ </simpara> </warning> <para> - Siehe auch <function>array_intersect</function>. + Siehe auch <function>array_diff_assoc</function>, + <function>array_intersect</function> und + <function>array_intersect_assoc</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/array/functions/array-intersect.xml diff -u phpdoc-de/reference/array/functions/array-intersect.xml:1.4 phpdoc-de/reference/array/functions/array-intersect.xml:1.5 --- phpdoc-de/reference/array/functions/array-intersect.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/array-intersect.xml Sat Jan 11 10:19:37 2003 @@ -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-intersect"> <refnamediv> <refname>array_intersect</refname> @@ -57,7 +57,9 @@ </simpara> </warning> <para> - Siehe auch <function>array_diff</function>. + Siehe auch <function>array_intersect_assoc</function>, + <function>array_diff</function> und + <function>array_diff_assoc</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/array/functions/array-map.xml diff -u phpdoc-de/reference/array/functions/array-map.xml:1.4 phpdoc-de/reference/array/functions/array-map.xml:1.5 --- phpdoc-de/reference/array/functions/array-map.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/array-map.xml Sat Jan 11 10:19:37 2003 @@ -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-map"> <refnamediv> <refname>array_map</refname> @@ -12,15 +12,16 @@ <title>Beschreibung</title> <methodsynopsis> <type>array</type><methodname>array_map</methodname> - <methodparam><type>mixed</type><parameter>callback</parameter></methodparam> + <methodparam><type>callback</type><parameter>function</parameter></methodparam> <methodparam><type>array</type><parameter>arr1</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter>arr2...</parameter></methodparam> </methodsynopsis> <para> <function>array_map</function> gibt ein Array mit allen Elementen von - <parameter>arr1</parameter> zurück, nachdem die Callback-Funktion auf - jedes einzelne Element angewandt wurde. Die Anzahl Parameter, welche - Callback-Funktion akzeptiert, sollte der Anzahl der an + <parameter>arr1</parameter> zurück, nachdem die Callback-Funktion + <parameter>function</parameter> auf jedes einzelne Element angewandt + wurde. Die Anzahl Parameter, welche die Callback-Funktion + <parameter>function</parameter> akzeptiert, sollte der Anzahl der an <function>array_map</function> übergebenen Arrays entsprechen. </para> <para> @@ -28,6 +29,7 @@ <title><function>array_map</function></title> <programlisting role="php"> <![CDATA[ +<?php function cube($n) { return $n*$n*$n; } @@ -35,6 +37,7 @@ $a = array(1, 2, 3, 4, 5); $b = array_map("cube", $a); print_r($b); +?> ]]> </programlisting> <para> @@ -61,6 +64,7 @@ </title> <programlisting role="php"> <![CDATA[ +<?php function show_Spanish($n, $m) { return "Die Zahl $n heißt auf Spanisch $m"; } @@ -77,6 +81,7 @@ $d = array_map("map_Spanish", $a , $b); print_r($d); +?> ]]> </programlisting> <para> @@ -144,12 +149,14 @@ <title>Erstellen eines Arrays mit Arrays</title> <programlisting role="php"> <![CDATA[ +<?php $a = array(1, 2, 3, 4, 5); $b = array("eins", "zwei", "drei", "vier", "fünf"); $c = array("uno", "dos", "tres", "cuatro", "cinco"); $d = array_map(null, $a, $b, $c); print_r($d); +?> ]]> </programlisting> </example> @@ -200,8 +207,9 @@ </screen> </para> <para> - Siehe auch <function>array_filter</function> und - <function>array_reduce</function>. + Siehe auch <function>array_filter</function>, + <function>array_reduce</function> und + <function>array_walk</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/array/functions/array-reduce.xml diff -u phpdoc-de/reference/array/functions/array-reduce.xml:1.4 phpdoc-de/reference/array/functions/array-reduce.xml:1.5 --- phpdoc-de/reference/array/functions/array-reduce.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/array-reduce.xml Sat Jan 11 10:19:37 2003 @@ -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-reduce"> <refnamediv> <refname>array_reduce</refname> @@ -14,17 +14,16 @@ <methodsynopsis> <type>mixed</type><methodname>array_reduce</methodname> <methodparam><type>array</type><parameter>input</parameter></methodparam> - <methodparam><type>mixed</type><parameter>callback</parameter></methodparam> + <methodparam><type>callback</type><parameter>function</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>initial</parameter></methodparam> </methodsynopsis> <para> - <function>array_reduce</function> wendet die - <parameter>callback</parameter> Funktion iterativ bei den - Elementen des Arrays <parameter>input</parameter> so an, dass das - Array auf einen einzigen Wert reduziert wird. Ist der optionale - Parameter <parameter>intial</parameter> angegeben, wird er am - Beginn des Prozesses, benutzt oder als Resultat verwendet, sollte - das Array leer sein. + <function>array_reduce</function> wendet die Funktion + <parameter>function</parameter> iterativ bei den Elementen des Arrays + <parameter>input</parameter> so an, dass das Array auf einen einzigen + Wert reduziert wird. Ist der optionale Parameter + <parameter>intial</parameter> angegeben, wird er am Beginn des Prozesses + benutzt oder als Resultat verwendet, sollte das Array leer sein. </para> <para> <example> Index: phpdoc-de/reference/array/functions/array-walk.xml diff -u phpdoc-de/reference/array/functions/array-walk.xml:1.5 phpdoc-de/reference/array/functions/array-walk.xml:1.6 --- phpdoc-de/reference/array/functions/array-walk.xml:1.5 Fri Oct 18 16:35:41 2002 +++ phpdoc-de/reference/array/functions/array-walk.xml Sat Jan 11 10:19:37 2003 @@ -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.7 Maintainer: tom Status: ready --> <refentry id="function.array-walk"> <refnamediv> <refname>array_walk</refname> @@ -13,30 +13,22 @@ <methodsynopsis> <type>int</type><methodname>array_walk</methodname> <methodparam><type>array</type><parameter>array</parameter></methodparam> - <methodparam><type>string</type><parameter>func</parameter></methodparam> + <methodparam><type>callback</type><parameter>function</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>userdata</parameter></methodparam> </methodsynopsis> <simpara> - Wendet die mittels <parameter>func</parameter> angegebene + Wendet die mittels <parameter>function</parameter> angegebene Benutzerfunktion für jedes Element von <parameter>array</parameter> - an. <parameter>func</parameter> benötigt zwei Parameter. Der Wert + an. <parameter>function</parameter> benötigt zwei Parameter. Der Wert von <parameter>array</parameter> wird als erster übergeben, und der Schlüssel/Index als zweites. Ist der optionale Parameter <parameter>userdata</parameter> angegeben, so wird er als dritter - Parameter an die Funktion <parameter>func</parameter> übergeben. + Parameter an die Funktion <parameter>function</parameter> übergeben. </simpara> <simpara> - <parameter>func</parameter> muss eine vom Benutzer definierte - Funktion sein, und nicht eine native PHP Funktion wie z.B. - <function>strtolower</function> oder - <function>stripslashes</function>. Die vom Benutzer definierte - Funktion kann native PHP Funktionen verwenden. - </simpara> - ¬e.func-callback; - <simpara> - Sollte <parameter>func</parameter> mehr als die ihr übergebenen + Sollte <parameter>function</parameter> mehr als die ihr übergebenen Parameter benötigen, wird bei jedem Aufruf von - <parameter>func</parameter> seitens <function>array_walk</function> + <parameter>function</parameter> seitens <function>array_walk</function> eine Fehlermeldung der Stufe <link linkend="errorfunc.constants"> E_WARNING</link> generiert. Diese Warnmeldungen können unterdrückt werden, indem man dem Funktionsaufruf von @@ -46,23 +38,22 @@ </simpara> <note> <para> - Wenn <parameter>func</parameter> direkt mit den Werten des + Wenn <parameter>function</parameter> direkt mit den Werten des Arrays arbeiten soll, spezifizieren Sie den ersten Parameter - von <parameter>func</parameter> als <link + von <parameter>function</parameter> als <link linkend="language.references">Referenz</link>. Dann werden alle Änderungen an diesen Elementen direkt in dem originalen Array durchgeführt. </para> <para> - Die Modifizierung des Arrays aus <parameter>func</parameter> + Die Modifizierung des Arrays aus <parameter>function</parameter> heraus könnte ein unvorhersehbares Verhalten hervorrufen. </para> </note> <note> <para> - Die Übergabe des Schlüssels und von - <parameter>userdata</parameter> an <parameter>func</parameter> - wurde mit PHP 4.0.0 eingeführt. + Die Übergabe des Schlüssels und von <parameter>userdata</parameter> + an <parameter>function</parameter> wurde mit PHP 4.0.0 eingeführt. </para> </note> <para> @@ -126,9 +117,9 @@ </example> </para> <simpara> - Siehe auch <function>list</function>, + Siehe auch <function>array_walk</function>, <function>list</function>, <link linkend="control-structures.foreach">foreach</link>, - <function>each</function> und <function>call_user_func_array</function>. + <function>each</function>, and <function>call_user_func_array</function>. </simpara> </refsect1> </refentry> Index: phpdoc-de/reference/array/functions/each.xml diff -u phpdoc-de/reference/array/functions/each.xml:1.6 phpdoc-de/reference/array/functions/each.xml:1.7 --- phpdoc-de/reference/array/functions/each.xml:1.6 Sun Oct 6 16:40:51 2002 +++ phpdoc-de/reference/array/functions/each.xml Sat Jan 11 10:19:37 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.6 Maintainer: tom Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.7 Maintainer: tom Status: ready --> <refentry id="function.each"> <refnamediv> <refname>each</refname> @@ -97,7 +97,7 @@ Siehe auch <function>key</function>, <function>list</function>, <function>current</function>, <function>reset</function>, <function>next</function>, <function>prev</function> und - <function>foreach</function>. + <link linkend="control-structures.foreach">foreach</link>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/array/functions/range.xml diff -u phpdoc-de/reference/array/functions/range.xml:1.4 phpdoc-de/reference/array/functions/range.xml:1.5 --- phpdoc-de/reference/array/functions/range.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/range.xml Sat Jan 11 10:19:37 2003 @@ -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.range"> <refnamediv> <refname>range</refname> @@ -14,6 +14,7 @@ <type>array</type><methodname>range</methodname> <methodparam><type>mixed</type><parameter>low</parameter></methodparam> <methodparam><type>mixed</type><parameter>high</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>step</parameter></methodparam> </methodsynopsis> <para> <function>range</function> gibt ein Array mit Elementen im @@ -21,51 +22,59 @@ <parameter>high</parameter> zurück. Wenn low > high, wird die Sequenz von high nach low sein. </para> + <note> + <title>Neuer parameter</title> + <simpara> + Der optionale Parameter <parameter>step</parameter> wurde in 4.4.0 eingeführt. + </simpara> + </note> + <para> + Ist ein <parameter>step</parameter> Wert angegeben, wird es Schrittweite + zwischen den Elementen in der Sequenz verwendet. <parameter>step</parameter> + sollte als positive Zahl angegeben werden. Ist <parameter>step</parameter> + nicht angegeben, wird automatisch der Wert 1 angenommen. + </para> + <para> <example> <title><function>range</function></title> <programlisting role="php"> <![CDATA[ +<?php +// array(0,1,2,3,4,5,6,7,8,9) foreach(range(0, 9) as $number) { echo $number; } -foreach(range('a', 'z') as $letter) { + +// Der Parameter step wurde in PHP 4.4.0 eingeführt +// array(0,10,20,30,40,50,60,70,80,90,100) +foreach(range(0, 100, 10) as $number) { + echo $number; +} + +// Die Verwendung von Zeichen wurde in 4.1.0 eingeführt +// array('a','b','c','d','e','f','g','h','i'); +foreach(range('a', 'i') as $letter) { echo $letter; } -foreach(range('z', 'a') as $letter) { +// array('c','b','a'); +foreach(range('c', 'a') as $letter) { echo $letter; } +?> ]]> </programlisting> </example> + </para> <note> <para> - Vor der Version 4.1.0 hat die Funktion - <function>range</function> nur aufsteigende Integer Arrays - erstellt. Die Unterstützung für Zeichenfolgen und Arrays in - absteigender Reihenfolge wurde in 4.1.0 hinzugefügt. + Vor der Version 4.1.0 hat die Funktion <function>range</function> nur + aufsteigende Integer Arrays erstellt. Die Unterstützung für Zeichenfolgen + und Arrays in absteigender Reihenfolge wurde in 4.1.0 hinzugefügt. </para> - <example> - <title>Dekrementieren von Bereichen und Zeichenketten simulieren</title> - <programlisting role="php"> -<![CDATA[ -# array_reverse kann dazu verwendet werden, -# die Reihenfolge eines Bereiches umzudrehen -foreach(array_reverse(range(0,9)) as $number) { - echo $number; -} - -# array_map() kann benutzt werden, um Integer-Werte mittels -# chr() in Zeichen umzuwandeln -foreach(array_map('chr', range(ord('a'),ord('z'))) as $character) { - echo $character; -} -]]> - </programlisting> - </example> </note> <para> - Siehe <function>shuffle</function> für ein weiteres - Anwendungsbeispiel. + Siehe auch <function>shuffle</function> und + <link linkend="control-structures.foreach">foreach</link>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/array/functions/uasort.xml diff -u phpdoc-de/reference/array/functions/uasort.xml:1.4 phpdoc-de/reference/array/functions/uasort.xml:1.5 --- phpdoc-de/reference/array/functions/uasort.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/uasort.xml Sat Jan 11 10:19:37 2003 @@ -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.uasort"> <refnamediv> <refname>uasort</refname> @@ -14,7 +14,7 @@ <methodsynopsis> <type>void</type><methodname>uasort</methodname> <methodparam><type>array</type><parameter>array</parameter></methodparam> - <methodparam><type>function</type><parameter>cmp_function</parameter></methodparam> + <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> </methodsynopsis> <para> Diese Funktion sortiert ein Array so, dass die Beziehung der @@ -29,7 +29,6 @@ für Beispiele von benutzerdefinierten Vergleichsfunktionen </para> </note> - ¬e.func-callback; <para> Siehe auch <function>usort</function>, <function>uksort</function>, <function>sort</function>, <function>asort</function>, Index: phpdoc-de/reference/array/functions/uksort.xml diff -u phpdoc-de/reference/array/functions/uksort.xml:1.4 phpdoc-de/reference/array/functions/uksort.xml:1.5 --- phpdoc-de/reference/array/functions/uksort.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/uksort.xml Sat Jan 11 10:19:37 2003 @@ -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.uksort"> <refnamediv> <refname>uksort</refname> @@ -14,7 +14,7 @@ <methodsynopsis> <type>void</type><methodname>uksort</methodname> <methodparam><type>array</type><parameter>array</parameter></methodparam> - <methodparam><type>function</type><parameter>cmp_function</parameter></methodparam> + <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> </methodsynopsis> <para> Diese Funktion sortiert die Schlüssel eines Arrays mittels einer @@ -54,7 +54,6 @@ ]]> </screen> </para> - ¬e.func-callback; <para> Siehe auch <function>usort</function>, <function>uasort</function>, <function>sort</function>, <function>asort</function>, Index: phpdoc-de/reference/array/functions/usort.xml diff -u phpdoc-de/reference/array/functions/usort.xml:1.5 phpdoc-de/reference/array/functions/usort.xml:1.6 --- phpdoc-de/reference/array/functions/usort.xml:1.5 Sun Oct 6 16:40:51 2002 +++ phpdoc-de/reference/array/functions/usort.xml Sat Jan 11 10:19:37 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.6 Maintainer: tom Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.7 Maintainer: tom Status: ready --> <refentry id="function.usort"> <refnamediv> <refname>usort</refname> @@ -14,7 +14,7 @@ <methodsynopsis> <type>void</type><methodname>usort</methodname> <methodparam><type>array</type><parameter>array</parameter></methodparam> - <methodparam><type>string</type><parameter>cmp_function</parameter></methodparam> + <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> </methodsynopsis> <para> Diese Funktion sortiert ein Array nach seinen Werten mittels @@ -119,7 +119,7 @@ ]]> </screen> </para> - ¬e.func-callback; + <para> <example> <title> @@ -168,14 +168,7 @@ d </screen> </para> - <warning> - <para> - Die zugrundeliegende quicksort Funktion in machen C - Bibliotheken (wie z.B. Solaris Systeme) könnte einen PHP Crash - verursachen, wenn die Vergleichsfunktion keine gleichbleibenden - Werte zurückgibt. - </para> - </warning> + <para> Siehe auch <function>uasort</function>, <function>uksort</function>, <function>sort</function>,
Index: phpdoc-de/reference/array/functions/array-diff.xml diff -u phpdoc-de/reference/array/functions/array-diff.xml:1.5 phpdoc-de/reference/array/functions/array-diff.xml:1.6 --- phpdoc-de/reference/array/functions/array-diff.xml:1.5 Sat Oct 5 18:47:01 2002 +++ phpdoc-de/reference/array/functions/array-diff.xml Sat Jan 11 10:19:37 2003 @@ -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.7 Maintainer: tom Status: ready --> <refentry id="function.array-diff"> <refnamediv> <refname>array_diff</refname> @@ -56,7 +56,9 @@ </simpara> </warning> <para> - Siehe auch <function>array_intersect</function>. + Siehe auch <function>array_diff_assoc</function>, + <function>array_intersect</function> und + <function>array_intersect_assoc</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/array/functions/array-intersect.xml diff -u phpdoc-de/reference/array/functions/array-intersect.xml:1.4 phpdoc-de/reference/array/functions/array-intersect.xml:1.5 --- phpdoc-de/reference/array/functions/array-intersect.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/array-intersect.xml Sat Jan 11 10:19:37 2003 @@ -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-intersect"> <refnamediv> <refname>array_intersect</refname> @@ -57,7 +57,9 @@ </simpara> </warning> <para> - Siehe auch <function>array_diff</function>. + Siehe auch <function>array_intersect_assoc</function>, + <function>array_diff</function> und + <function>array_diff_assoc</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/array/functions/array-map.xml diff -u phpdoc-de/reference/array/functions/array-map.xml:1.4 phpdoc-de/reference/array/functions/array-map.xml:1.5 --- phpdoc-de/reference/array/functions/array-map.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/array-map.xml Sat Jan 11 10:19:37 2003 @@ -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-map"> <refnamediv> <refname>array_map</refname> @@ -12,15 +12,16 @@ <title>Beschreibung</title> <methodsynopsis> <type>array</type><methodname>array_map</methodname> - <methodparam><type>mixed</type><parameter>callback</parameter></methodparam> + <methodparam><type>callback</type><parameter>function</parameter></methodparam> <methodparam><type>array</type><parameter>arr1</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter>arr2...</parameter></methodparam> </methodsynopsis> <para> <function>array_map</function> gibt ein Array mit allen Elementen von - <parameter>arr1</parameter> zurück, nachdem die Callback-Funktion auf - jedes einzelne Element angewandt wurde. Die Anzahl Parameter, welche - Callback-Funktion akzeptiert, sollte der Anzahl der an + <parameter>arr1</parameter> zurück, nachdem die Callback-Funktion + <parameter>function</parameter> auf jedes einzelne Element angewandt + wurde. Die Anzahl Parameter, welche die Callback-Funktion + <parameter>function</parameter> akzeptiert, sollte der Anzahl der an <function>array_map</function> übergebenen Arrays entsprechen. </para> <para> @@ -28,6 +29,7 @@ <title><function>array_map</function></title> <programlisting role="php"> <![CDATA[ +<?php function cube($n) { return $n*$n*$n; } @@ -35,6 +37,7 @@ $a = array(1, 2, 3, 4, 5); $b = array_map("cube", $a); print_r($b); +?> ]]> </programlisting> <para> @@ -61,6 +64,7 @@ </title> <programlisting role="php"> <![CDATA[ +<?php function show_Spanish($n, $m) { return "Die Zahl $n heißt auf Spanisch $m"; } @@ -77,6 +81,7 @@ $d = array_map("map_Spanish", $a , $b); print_r($d); +?> ]]> </programlisting> <para> @@ -144,12 +149,14 @@ <title>Erstellen eines Arrays mit Arrays</title> <programlisting role="php"> <![CDATA[ +<?php $a = array(1, 2, 3, 4, 5); $b = array("eins", "zwei", "drei", "vier", "fünf"); $c = array("uno", "dos", "tres", "cuatro", "cinco"); $d = array_map(null, $a, $b, $c); print_r($d); +?> ]]> </programlisting> </example> @@ -200,8 +207,9 @@ </screen> </para> <para> - Siehe auch <function>array_filter</function> und - <function>array_reduce</function>. + Siehe auch <function>array_filter</function>, + <function>array_reduce</function> und + <function>array_walk</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/array/functions/array-reduce.xml diff -u phpdoc-de/reference/array/functions/array-reduce.xml:1.4 phpdoc-de/reference/array/functions/array-reduce.xml:1.5 --- phpdoc-de/reference/array/functions/array-reduce.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/array-reduce.xml Sat Jan 11 10:19:37 2003 @@ -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-reduce"> <refnamediv> <refname>array_reduce</refname> @@ -14,17 +14,16 @@ <methodsynopsis> <type>mixed</type><methodname>array_reduce</methodname> <methodparam><type>array</type><parameter>input</parameter></methodparam> - <methodparam><type>mixed</type><parameter>callback</parameter></methodparam> + <methodparam><type>callback</type><parameter>function</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>initial</parameter></methodparam> </methodsynopsis> <para> - <function>array_reduce</function> wendet die - <parameter>callback</parameter> Funktion iterativ bei den - Elementen des Arrays <parameter>input</parameter> so an, dass das - Array auf einen einzigen Wert reduziert wird. Ist der optionale - Parameter <parameter>intial</parameter> angegeben, wird er am - Beginn des Prozesses, benutzt oder als Resultat verwendet, sollte - das Array leer sein. + <function>array_reduce</function> wendet die Funktion + <parameter>function</parameter> iterativ bei den Elementen des Arrays + <parameter>input</parameter> so an, dass das Array auf einen einzigen + Wert reduziert wird. Ist der optionale Parameter + <parameter>intial</parameter> angegeben, wird er am Beginn des Prozesses + benutzt oder als Resultat verwendet, sollte das Array leer sein. </para> <para> <example> Index: phpdoc-de/reference/array/functions/array-walk.xml diff -u phpdoc-de/reference/array/functions/array-walk.xml:1.5 phpdoc-de/reference/array/functions/array-walk.xml:1.6 --- phpdoc-de/reference/array/functions/array-walk.xml:1.5 Fri Oct 18 16:35:41 2002 +++ phpdoc-de/reference/array/functions/array-walk.xml Sat Jan 11 10:19:37 2003 @@ -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.7 Maintainer: tom Status: ready --> <refentry id="function.array-walk"> <refnamediv> <refname>array_walk</refname> @@ -13,30 +13,22 @@ <methodsynopsis> <type>int</type><methodname>array_walk</methodname> <methodparam><type>array</type><parameter>array</parameter></methodparam> - <methodparam><type>string</type><parameter>func</parameter></methodparam> + <methodparam><type>callback</type><parameter>function</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>userdata</parameter></methodparam> </methodsynopsis> <simpara> - Wendet die mittels <parameter>func</parameter> angegebene + Wendet die mittels <parameter>function</parameter> angegebene Benutzerfunktion für jedes Element von <parameter>array</parameter> - an. <parameter>func</parameter> benötigt zwei Parameter. Der Wert + an. <parameter>function</parameter> benötigt zwei Parameter. Der Wert von <parameter>array</parameter> wird als erster übergeben, und der Schlüssel/Index als zweites. Ist der optionale Parameter <parameter>userdata</parameter> angegeben, so wird er als dritter - Parameter an die Funktion <parameter>func</parameter> übergeben. + Parameter an die Funktion <parameter>function</parameter> übergeben. </simpara> <simpara> - <parameter>func</parameter> muss eine vom Benutzer definierte - Funktion sein, und nicht eine native PHP Funktion wie z.B. - <function>strtolower</function> oder - <function>stripslashes</function>. Die vom Benutzer definierte - Funktion kann native PHP Funktionen verwenden. - </simpara> - ¬e.func-callback; - <simpara> - Sollte <parameter>func</parameter> mehr als die ihr übergebenen + Sollte <parameter>function</parameter> mehr als die ihr übergebenen Parameter benötigen, wird bei jedem Aufruf von - <parameter>func</parameter> seitens <function>array_walk</function> + <parameter>function</parameter> seitens <function>array_walk</function> eine Fehlermeldung der Stufe <link linkend="errorfunc.constants"> E_WARNING</link> generiert. Diese Warnmeldungen können unterdrückt werden, indem man dem Funktionsaufruf von @@ -46,23 +38,22 @@ </simpara> <note> <para> - Wenn <parameter>func</parameter> direkt mit den Werten des + Wenn <parameter>function</parameter> direkt mit den Werten des Arrays arbeiten soll, spezifizieren Sie den ersten Parameter - von <parameter>func</parameter> als <link + von <parameter>function</parameter> als <link linkend="language.references">Referenz</link>. Dann werden alle Änderungen an diesen Elementen direkt in dem originalen Array durchgeführt. </para> <para> - Die Modifizierung des Arrays aus <parameter>func</parameter> + Die Modifizierung des Arrays aus <parameter>function</parameter> heraus könnte ein unvorhersehbares Verhalten hervorrufen. </para> </note> <note> <para> - Die Übergabe des Schlüssels und von - <parameter>userdata</parameter> an <parameter>func</parameter> - wurde mit PHP 4.0.0 eingeführt. + Die Übergabe des Schlüssels und von <parameter>userdata</parameter> + an <parameter>function</parameter> wurde mit PHP 4.0.0 eingeführt. </para> </note> <para> @@ -126,9 +117,9 @@ </example> </para> <simpara> - Siehe auch <function>list</function>, + Siehe auch <function>array_walk</function>, <function>list</function>, <link linkend="control-structures.foreach">foreach</link>, - <function>each</function> und <function>call_user_func_array</function>. + <function>each</function>, and <function>call_user_func_array</function>. </simpara> </refsect1> </refentry> Index: phpdoc-de/reference/array/functions/each.xml diff -u phpdoc-de/reference/array/functions/each.xml:1.6 phpdoc-de/reference/array/functions/each.xml:1.7 --- phpdoc-de/reference/array/functions/each.xml:1.6 Sun Oct 6 16:40:51 2002 +++ phpdoc-de/reference/array/functions/each.xml Sat Jan 11 10:19:37 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.6 Maintainer: tom Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.7 Maintainer: tom Status: ready --> <refentry id="function.each"> <refnamediv> <refname>each</refname> @@ -97,7 +97,7 @@ Siehe auch <function>key</function>, <function>list</function>, <function>current</function>, <function>reset</function>, <function>next</function>, <function>prev</function> und - <function>foreach</function>. + <link linkend="control-structures.foreach">foreach</link>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/array/functions/range.xml diff -u phpdoc-de/reference/array/functions/range.xml:1.4 phpdoc-de/reference/array/functions/range.xml:1.5 --- phpdoc-de/reference/array/functions/range.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/range.xml Sat Jan 11 10:19:37 2003 @@ -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.range"> <refnamediv> <refname>range</refname> @@ -14,6 +14,7 @@ <type>array</type><methodname>range</methodname> <methodparam><type>mixed</type><parameter>low</parameter></methodparam> <methodparam><type>mixed</type><parameter>high</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>step</parameter></methodparam> </methodsynopsis> <para> <function>range</function> gibt ein Array mit Elementen im @@ -21,51 +22,59 @@ <parameter>high</parameter> zurück. Wenn low > high, wird die Sequenz von high nach low sein. </para> + <note> + <title>Neuer parameter</title> + <simpara> + Der optionale Parameter <parameter>step</parameter> wurde in 4.4.0 eingeführt. + </simpara> + </note> + <para> + Ist ein <parameter>step</parameter> Wert angegeben, wird es Schrittweite + zwischen den Elementen in der Sequenz verwendet. <parameter>step</parameter> + sollte als positive Zahl angegeben werden. Ist <parameter>step</parameter> + nicht angegeben, wird automatisch der Wert 1 angenommen. + </para> + <para> <example> <title><function>range</function></title> <programlisting role="php"> <![CDATA[ +<?php +// array(0,1,2,3,4,5,6,7,8,9) foreach(range(0, 9) as $number) { echo $number; } -foreach(range('a', 'z') as $letter) { + +// Der Parameter step wurde in PHP 4.4.0 eingeführt +// array(0,10,20,30,40,50,60,70,80,90,100) +foreach(range(0, 100, 10) as $number) { + echo $number; +} + +// Die Verwendung von Zeichen wurde in 4.1.0 eingeführt +// array('a','b','c','d','e','f','g','h','i'); +foreach(range('a', 'i') as $letter) { echo $letter; } -foreach(range('z', 'a') as $letter) { +// array('c','b','a'); +foreach(range('c', 'a') as $letter) { echo $letter; } +?> ]]> </programlisting> </example> + </para> <note> <para> - Vor der Version 4.1.0 hat die Funktion - <function>range</function> nur aufsteigende Integer Arrays - erstellt. Die Unterstützung für Zeichenfolgen und Arrays in - absteigender Reihenfolge wurde in 4.1.0 hinzugefügt. + Vor der Version 4.1.0 hat die Funktion <function>range</function> nur + aufsteigende Integer Arrays erstellt. Die Unterstützung für Zeichenfolgen + und Arrays in absteigender Reihenfolge wurde in 4.1.0 hinzugefügt. </para> - <example> - <title>Dekrementieren von Bereichen und Zeichenketten simulieren</title> - <programlisting role="php"> -<![CDATA[ -# array_reverse kann dazu verwendet werden, -# die Reihenfolge eines Bereiches umzudrehen -foreach(array_reverse(range(0,9)) as $number) { - echo $number; -} - -# array_map() kann benutzt werden, um Integer-Werte mittels -# chr() in Zeichen umzuwandeln -foreach(array_map('chr', range(ord('a'),ord('z'))) as $character) { - echo $character; -} -]]> - </programlisting> - </example> </note> <para> - Siehe <function>shuffle</function> für ein weiteres - Anwendungsbeispiel. + Siehe auch <function>shuffle</function> und + <link linkend="control-structures.foreach">foreach</link>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/array/functions/uasort.xml diff -u phpdoc-de/reference/array/functions/uasort.xml:1.4 phpdoc-de/reference/array/functions/uasort.xml:1.5 --- phpdoc-de/reference/array/functions/uasort.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/uasort.xml Sat Jan 11 10:19:37 2003 @@ -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.uasort"> <refnamediv> <refname>uasort</refname> @@ -14,7 +14,7 @@ <methodsynopsis> <type>void</type><methodname>uasort</methodname> <methodparam><type>array</type><parameter>array</parameter></methodparam> - <methodparam><type>function</type><parameter>cmp_function</parameter></methodparam> + <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> </methodsynopsis> <para> Diese Funktion sortiert ein Array so, dass die Beziehung der @@ -29,7 +29,6 @@ für Beispiele von benutzerdefinierten Vergleichsfunktionen </para> </note> - ¬e.func-callback; <para> Siehe auch <function>usort</function>, <function>uksort</function>, <function>sort</function>, <function>asort</function>, Index: phpdoc-de/reference/array/functions/uksort.xml diff -u phpdoc-de/reference/array/functions/uksort.xml:1.4 phpdoc-de/reference/array/functions/uksort.xml:1.5 --- phpdoc-de/reference/array/functions/uksort.xml:1.4 Fri May 31 13:47:06 2002 +++ phpdoc-de/reference/array/functions/uksort.xml Sat Jan 11 10:19:37 2003 @@ -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.uksort"> <refnamediv> <refname>uksort</refname> @@ -14,7 +14,7 @@ <methodsynopsis> <type>void</type><methodname>uksort</methodname> <methodparam><type>array</type><parameter>array</parameter></methodparam> - <methodparam><type>function</type><parameter>cmp_function</parameter></methodparam> + <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> </methodsynopsis> <para> Diese Funktion sortiert die Schlüssel eines Arrays mittels einer @@ -54,7 +54,6 @@ ]]> </screen> </para> - ¬e.func-callback; <para> Siehe auch <function>usort</function>, <function>uasort</function>, <function>sort</function>, <function>asort</function>, Index: phpdoc-de/reference/array/functions/usort.xml diff -u phpdoc-de/reference/array/functions/usort.xml:1.5 phpdoc-de/reference/array/functions/usort.xml:1.6 --- phpdoc-de/reference/array/functions/usort.xml:1.5 Sun Oct 6 16:40:51 2002 +++ phpdoc-de/reference/array/functions/usort.xml Sat Jan 11 10:19:37 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.6 Maintainer: tom Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.7 Maintainer: tom Status: ready --> <refentry id="function.usort"> <refnamediv> <refname>usort</refname> @@ -14,7 +14,7 @@ <methodsynopsis> <type>void</type><methodname>usort</methodname> <methodparam><type>array</type><parameter>array</parameter></methodparam> - <methodparam><type>string</type><parameter>cmp_function</parameter></methodparam> + <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> </methodsynopsis> <para> Diese Funktion sortiert ein Array nach seinen Werten mittels @@ -119,7 +119,7 @@ ]]> </screen> </para> - ¬e.func-callback; + <para> <example> <title> @@ -168,14 +168,7 @@ d </screen> </para> - <warning> - <para> - Die zugrundeliegende quicksort Funktion in machen C - Bibliotheken (wie z.B. Solaris Systeme) könnte einen PHP Crash - verursachen, wenn die Vergleichsfunktion keine gleichbleibenden - Werte zurückgibt. - </para> - </warning> + <para> Siehe auch <function>uasort</function>, <function>uksort</function>, <function>sort</function>,