cvs: phpdoc /de/functions array.xml

eschmid Wed Oct 17 18:06:28 2001 EDT Modified files: /phpdoc/de/functions array.xml Log: White space and some punctuation.

Index: phpdoc/de/functions/array.xml diff -u phpdoc/de/functions/array.xml:1.22 phpdoc/de/functions/array.xml:1.23 --- phpdoc/de/functions/array.xml:1.22 Wed Oct 17 17:17:35 2001 +++ phpdoc/de/functions/array.xml Wed Oct 17 18:06:28 2001 @@ -4,26 +4,28 @@ <titleabbrev>Arrays</titleabbrev> <partintro> <simpara> - Diese Funktionen erlauben es, Arrays auf verschiedene Arten zu - manipulieren bzw. mit ihnen zu interagieren. Arrays sind wichtig, um - Gruppen von Variablen zu verwalten, zu bearbeiten, oder zu speichern. + Diese Funktionen erlauben es, Arrays auf verschiedene Arten zu + manipulieren bzw. mit ihnen zu interagieren. Arrays sind wichtig, + um Gruppen von Variablen zu verwalten, zu bearbeiten, oder zu + speichern. </simpara> <simpara> - Es werden einfache und mehrdimensionale Arrays unterstützt, welche - entweder vom Benutzer oder von einer anderen Funktion erstellt werden - können. Es gibt bestimmte Datenbankfunktionen, welche die Ergebnisse - aus Datenbankabfragen in Arrays speichern, und verschiedene andere - Funktionen, die Arrays als Rückgabewerte haben. + Es werden einfache und mehrdimensionale Arrays unterstützt, welche + entweder vom Benutzer oder von einer anderen Funktion erstellt + werden können. Es gibt bestimmte Datenbankfunktionen, welche die + Ergebnisse aus Datenbankabfragen in Arrays speichern, und + verschiedene andere Funktionen, die Arrays als Rückgabewerte + haben. </simpara> <para> In der Sektion <link linkend="language.types.array">Arrays</link> - finden Sie eine detailierte Erklärung, wie Arrays in PHP implementiert - sind und wie sie benutzt werden. + finden Sie eine detailierte Erklärung, wie Arrays in PHP + implementiert sind und wie sie benutzt werden. </para> <para> - Siehe auch <function>is_array</function>, <function>explode</function>, - <function>implode</function>, <function>split</function>, - und <function>join</function>. + Siehe auch <function>is_array</function>, + <function>explode</function>, <function>implode</function>, + <function>split</function> und <function>join</function>. </para> </partintro> @@ -57,13 +59,13 @@ </note> </para> <para> - Die Syntax "Index =&gt; Werte", durch Kommas getrennt, definiert - Index und Werte. Index kann vom Typ String oder numerisch sein. - Wird der Index weggelassen, erstellt die Funktion automatisch einen - numerischen Index, der bei 0 beginnt. Ist der Index als Integer-Wert - angegeben, wird der nächste generierte Index der größte Integer - Index + 1. Beachten Sie, dass wenn zwei identische Indexe definiert - sind, der letzte den ersten überschreibt. + Die Syntax "Index =&gt; Werte", durch Kommas getrennt, definiert + Index und Werte. Index kann vom Typ String oder numerisch sein. + Wird der Index weggelassen, erstellt die Funktion automatisch + einen numerischen Index, der bei 0 beginnt. Ist der Index als + Integer-Wert angegeben, wird der nächste generierte Index der + größte Integer Index + 1. Beachten Sie, dass wenn zwei identische + Indexe definiert sind, der letzte den ersten überschreibt. </para> <para> Das folgende Beispiel zeigt wie man ein zweidimensionales Array @@ -110,12 +112,12 @@ 8 war. </para> <para> - Dieses Beispiel erstellt ein auf dem Index 1 basierendes Array. + Dieses Beispiel erstellt ein auf dem Index 1 basierendes Array. <example> <title>1-basierter Index mit <function>array</function></title> <programlisting role="php"> - $erstesquartal = array(1 => 'Januar', 'Februar', 'März'); - print_r($erstesquartal); +$erstesquartal = array(1 => 'Januar', 'Februar', 'März'); +print_r($erstesquartal); </programlisting> </example> wird folgendes ausgeben: @@ -150,9 +152,9 @@ </funcprototype> </funcsynopsis> <para> - <function>array_count_values</function> gibt ein Array zurück, in dem - die Werte des Arrays <parameter>input</parameter> als Schlüssel, und - deren Anzahl als Werte angegeben sind. + <function>array_count_values</function> gibt ein Array zurück, in + dem die Werte des Arrays <parameter>input</parameter> als + Schlüssel, und deren Anzahl als Werte angegeben sind. </para> <para> <example> @@ -199,8 +201,9 @@ </example> </para> <para> - Dies speichert <literal>array("blau");</literal> in <varname>$result</varname>. - Mehrfache Vorkommen in $array1 werden auf die gleiche Weise behandelt. + Dies speichert <literal>array("blau");</literal> in + <varname>$result</varname>. Mehrfache Vorkommen in $array1 + werden auf die gleiche Weise behandelt. </para> <para> Siehe auch <function>array_intersect</function>. @@ -211,8 +214,9 @@ <refentry id="function.array-filter"> <refnamediv> <refname>array_filter</refname> - <refpurpose>Filtert Elemente eines Arrays mittels einer - Callback-Funktion</refpurpose> + <refpurpose> + Filtert Elemente eines Arrays mittels einer Callback-Funktion + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -226,21 +230,22 @@ </funcprototype> </funcsynopsis> <para> - <function>array_filter</function> gibt ein Array mit den mittels der - Callback-Funktion gefilterten Elementen von <parameter>input</parameter> - zurück. Ist <parameter>input</parameter> ein assoziatives Array, bleiben - die Schlüssel erhalten. + <function>array_filter</function> gibt ein Array mit den mittels + der Callback-Funktion gefilterten Elementen von + <parameter>input</parameter> zurück. Ist + <parameter>input</parameter> ein assoziatives Array, bleiben die + Schlüssel erhalten. </para> <para> <example> <title><function>array_filter</function></title> <programlisting role="php"> function ungerade($var) { - return ($var % 2 == 1); + return ($var % 2 == 1); } function gerade($var) { - return ($var % 2 == 0); + return ($var % 2 == 0); } $array1 = array ("a"=&gt;1, "b"=&gt;2, "c"=&gt;3, "d"=&gt;4, "e"=&gt;5); @@ -252,9 +257,10 @@ </example> </para> <para> - Dies speichert <literal>array ("a"=&gt;1, "c"=&gt;3, "e"=&gt;5);</literal> - in <varname>$ungerade_arr</varname>, und - <literal>array (6, 8, 10, 12);</literal> in <varname>$gerade_arr</varname>. + Dies speichert <literal>array ("a"=&gt;1, "c"=&gt;3, + "e"=&gt;5);</literal> in <varname>$ungerade_arr</varname>, und + <literal>array (6, 8, 10, 12);</literal> in + <varname>$gerade_arr</varname>. </para> <para> Siehe auch <function>array_map</function>, @@ -266,7 +272,9 @@ <refentry id="function.array-flip"> <refnamediv> <refname>array_flip</refname> - <refpurpose>Vertauscht Werte und Schlüssel in einem Array</refpurpose> + <refpurpose> + Vertauscht Werte und Schlüssel in einem Array + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -277,17 +285,19 @@ </funcprototype> </funcsynopsis> <para> - <function>array_flip</function> Gibt ein Array in umgekehrter - Reihenfolge zurück, d.h. Schlüssel von <parameter>trans</parameter> - werden Werte, und umgekehrt werden die Werte zu Schlüsseln. Beachten - Sie, dass <function>array_flip</function> nur mit den Typen Integer - und String arbeitet und eine Fehlermeldung ausgibt, wenn ein ungültiger - Schlüssel oder Wert entdeckt wird (z.B. vom Typ Array, Double, Object, - Boolean). + <function>array_flip</function> Gibt ein Array in umgekehrter + Reihenfolge zurück, d.h. Schlüssel von + <parameter>trans</parameter> werden Werte, und umgekehrt werden + die Werte zu Schlüsseln. Beachten Sie, dass + <function>array_flip</function> nur mit den Typen Integer und + String arbeitet und eine Fehlermeldung ausgibt, wenn ein + ungültiger Schlüssel oder Wert entdeckt wird (z.B. vom Typ Array, + Double, Object, Boolean). </para> <para> - Kommt ein Wert mehrmals vor, wird der letzte Schlüssel mit seinem Wert - vertauscht, und alle anderen Schlüssel- Wertepaare gehen verloren. + Kommt ein Wert mehrmals vor, wird der letzte Schlüssel mit seinem + Wert vertauscht, und alle anderen Schlüssel- Wertepaare gehen + verloren. </para> <para> <function>array_flip</function> gibt im Fehlerfall @@ -328,7 +338,7 @@ <paramdef>array <parameter>array1</parameter></paramdef> <paramdef>array <parameter>array2</parameter></paramdef> <paramdef>array - <parameter><optional> ...</optional></parameter> + <parameter><optional>...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -407,17 +417,19 @@ Implementierung für Benutzer von PHP 3. <example> <title> - Implementierung von <function>array_keys</function> für Benutzer von PHP 3: + Implementierung von <function>array_keys</function> für + Benutzer von PHP 3: </title> <programlisting role="php"> function array_keys ($arr, $term="") { $t = array(); while (list($k,$v) = each($arr)) { - if ($term &amp;&amp; $v != $term) + if ($term &amp;&amp; $v != $term) { continue; $t[] = $k; } return $t; + } } </programlisting> </example> @@ -432,8 +444,9 @@ <refentry id="function.array-map"> <refnamediv> <refname>array_map</refname> - <refpurpose>Wendet eine Callback-Funktion auf die Elemente von Arrays - an</refpurpose> + <refpurpose> + Wendet eine Callback-Funktion auf die Elemente von Arrays an + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -443,21 +456,21 @@ <paramdef>mixed <parameter>callback</parameter></paramdef> <paramdef>array <parameter>arr1</parameter></paramdef> <paramdef>array - <parameter><optional>arr2...</optional></parameter> + <parameter><optional>...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> - <function>array_map</function> wendet die Callback-Funktion auf alle - Elemente von <parameter>arr1</parameter> an, und gibt ein Array mit - den modifizierten Werten zurück. + <function>array_map</function> wendet die Callback-Funktion auf + alle Elemente von <parameter>arr1</parameter> an, und gibt ein + Array mit den modifizierten Werten zurück. </para> <para> <example> <title><function>array_map</function></title> <programlisting role="php"> function cube($n) { - return $n*$n*$n; + return $n*$n*$n; } $a = array(1, 2, 3, 4, 5); @@ -467,19 +480,20 @@ </para> <para> Dies speichert <literal>array (1, 8, 27, 64, 125);</literal> - in <varname>$b</varname>. - + in <varname>$b</varname>. </para> <para> <example> - <title><function>array_map</function> - Verwendung mehrerer Arrays</title> + <title> + <function>array_map</function> - Verwendung mehrerer Arrays + </title> <programlisting role="php"> function show_Spanish($n, $m) { - return "Die Zahl $n heißt auf Spanisch $m"; + return "Die Zahl $n heißt auf Spanisch $m"; } function map_Spanish($n, $m) { - return array ($n => $m); + return array ($n => $m); } $a = array(1, 2, 3, 4, 5); @@ -536,21 +550,23 @@ </example> </para> <para> - Bei Verwendung von zwei oder mehr Arrays sollten diese gewöhnlich die - gleiche Länge besitzen, da die Callback-Funktion parallel auf die - entsprechenden Elemente angewandt wird. - Haben die Arrays unterschiedliche Längen, wird das kürzeste um leere - Elemente erweitert. + Bei Verwendung von zwei oder mehr Arrays sollten diese gewöhnlich + die gleiche Länge besitzen, da die Callback-Funktion parallel auf + die entsprechenden Elemente angewandt wird. Haben die Arrays + unterschiedliche Längen, wird das kürzeste um leere Elemente + erweitert. </para> <para> - Eine interessante Anwendung dieser Funktion ist die Konstruktion eines - Arrays bestehend aus Arrays, was mit &null; als Name - der Callback-Funktion leicht realisiert werden kann. + Eine interessante Anwendung dieser Funktion ist die Konstruktion + eines Arrays bestehend aus Arrays, was mit &null; als Name der + Callback-Funktion leicht realisiert werden kann. </para> <para> <example> - <title><function>array_map</function> - Erstellen eines Arrays mit - Arrays</title> + <title> + <function>array_map</function> - Erstellen eines Arrays mit + Arrays + </title> <programlisting role="php"> $a = array(1, 2, 3, 4, 5); $b = array("one", "two", "three", "four", "five"); @@ -602,7 +618,7 @@ </example> </para> <para> - Siehe auch <function>array_filter</function>, + Siehe auch <function>array_filter</function> und <function>array_reduce</function>. </para> </refsect1> @@ -626,16 +642,17 @@ </funcprototype> </funcsynopsis> <para> - <function>array_merge</function> fügt die Elemente von zwei oder mehr - Arrays zusammen, indem die Werte des einen an das Ende des anderen - angehängt werden. Das daraus resultierende Array wird zurückgegeben. + <function>array_merge</function> fügt die Elemente von zwei oder + mehr Arrays zusammen, indem die Werte des einen an das Ende des + anderen angehängt werden. Das daraus resultierende Array wird + zurückgegeben. </para> <para> - 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. + 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. </para> <para> <example> @@ -648,8 +665,8 @@ </example> </para> <para> - Das resultierende Array wird <literal>array("farbe" =&gt; "grün", 2, 4, - "a", "b", "form" =&gt; "trapezoid", 4)</literal>. + Das resultierende Array wird <literal>array("farbe" =&gt; "grün", + 2, 4, "a", "b", "form" =&gt; "trapezoid", 4)</literal>. </para> <para> Siehe auch <function>array_merge_recursive</function>. @@ -660,7 +677,9 @@ <refentry id="function.array-merge-recursive"> <refnamediv> <refname>array_merge_recursive</refname> - <refpurpose>Führt zwei oder mehr Arrays rekursiv zusammen</refpurpose> + <refpurpose> + Führt zwei oder mehr Arrays rekursiv zusammen + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -675,17 +694,17 @@ </funcprototype> </funcsynopsis> <para> - <function>array_merge_recursive</function> fügt die Elemente von zwei - oder mehr Arrays zusammen, so dass die Werte des einen Arrays an die - des vorigen angehängt werden. Das daraus resultierende Array wird - zurückgegeben. + <function>array_merge_recursive</function> fügt die Elemente von + zwei oder mehr Arrays zusammen, so dass die Werte des einen + Arrays an die des vorigen angehängt werden. Das daraus + resultierende Array wird zurückgegeben. </para> <para> - 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. + 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. </para> <para> <example> @@ -699,7 +718,8 @@ </para> <para> Resulting array will be <literal>array ("color" =&gt; array - ("favorite" =&gt; array ("red", "green"), "blue"), 5, 10)</literal>. + ("favorite" =&gt; array ("red", "green"), "blue"), 5, + 10)</literal>. </para> <para> See also <function>array_merge</function>. @@ -710,7 +730,9 @@ <refentry id="function.array-multisort"> <refnamediv> <refname>array_multisort</refname> - <refpurpose>Sortiert mehrere oder multidimensionale Arrays</refpurpose> + <refpurpose> + Sortiert mehrere oder multidimensionale Arrays + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -730,31 +752,37 @@ </funcprototype> </funcsynopsis> <para> - <function>array_multisort</function> wird zum Sortieren von entweder - mehreren Arrays auf einmal, oder eines multidimensionalen Arrays - (entsprechend einer von mehreren Dimensionen) benutzt. Bei der - Sortierung werden die Schlüsselassoziationen beibehalten. - </para> - <para> - Die angegebenen Arrays werden als Spalten einer Tabelle behandelt, - welche nach Reihen sortiert werden - ähnlich der SQL Klausel ORDER BY. - Das erste Array ist auch das erste in der Sortierreihenfolge. Die in - diesem Array gleichen Zeilen (Werte) werden anhand des nächsten - angegebenen Arrays sortiert, usw. - </para> - <para> - Die Struktur der Argumente ist etwas ungewöhnlich, aber flexibel. Das - allererste Argument muss ein Array sein. Die nachfolgenden Argumente - können entweder ein Array oder eines der folgenden Sortierflags sein. + <function>array_multisort</function> wird zum Sortieren von + entweder mehreren Arrays auf einmal, oder eines + multidimensionalen Arrays (entsprechend einer von mehreren + Dimensionen) benutzt. Bei der Sortierung werden die + Schlüsselassoziationen beibehalten. + </para> + <para> + Die angegebenen Arrays werden als Spalten einer Tabelle + behandelt, welche nach Reihen sortiert werden - ähnlich der SQL + Klausel ORDER BY. Das erste Array ist auch das erste in der + Sortierreihenfolge. Die in diesem Array gleichen Zeilen (Werte) + werden anhand des nächsten angegebenen Arrays sortiert, usw. + </para> + <para> + Die Struktur der Argumente ist etwas ungewöhnlich, aber + flexibel. Das allererste Argument muss ein Array sein. Die + nachfolgenden Argumente können entweder ein Array oder eines der + folgenden Sortierflags sein. </para> <para> Flags für Sortierreihenfolge: <itemizedlist> <listitem> - <simpara>SORT_ASC - sortiere in aufsteigender Reihenfolge</simpara> + <simpara> + SORT_ASC - sortiere in aufsteigender Reihenfolge + </simpara> </listitem> <listitem> - <simpara>SORT_DESC - sortiere in absteigender Reihenfolge</simpara> + <simpara> + SORT_DESC - sortiere in absteigender Reihenfolge + </simpara> </listitem> </itemizedlist> </para> @@ -773,10 +801,11 @@ </itemizedlist> </para> <para> - Es kann nur ein Sortierflag des selben Typs nach jedem Array - spezifiziert werden. Sortierflags nach einem Array Argument gelten - nur für dieses Array, und werden vor jedem neuen Array Argument zu - den Defaultflags SORT_ASC und SORT_REGULAR zurückgesetzt. + Es kann nur ein Sortierflag des selben Typs nach jedem Array + spezifiziert werden. Sortierflags nach einem Array Argument + gelten nur für dieses Array, und werden vor jedem neuen Array + Argument zu den Defaultflags SORT_ASC und SORT_REGULAR + zurückgesetzt. </para> <para> Liefert bei Erfolg &true;, und im Fehlerfall @@ -794,9 +823,10 @@ </para> <para> In diesem Beispiel enthält das erste Array nach dem Sortieren 10, - "a", 100, 100. Das zweite Array wird 1, 1, "2", 3 enthalten. Die - Einträge des zweiten Arrays, welche den identischen Einträgen des - ersten Arrays entsprechen (100 und 100) wurden ebenfalls sortiert. + "a", 100, 100. Das zweite Array wird 1, 1, "2", 3 enthalten. Die + Einträge des zweiten Arrays, welche den identischen Einträgen des + ersten Arrays entsprechen (100 und 100) wurden ebenfalls + sortiert. </para> <para> <example> @@ -810,8 +840,8 @@ </para> <para> In diesem Beispiel enthält das erste Array nach dem Sortieren 10, - 100, 100, "a" (wurde als Strings in aufsteigender Reihenfolge - sortiert), und das zweite enthält 1, 3, "2", 1 (numerisch und + 100, 100, "a" (wurde als Strings in aufsteigender Reihenfolge + sortiert), und das zweite enthält 1, 3, "2", 1 (numerisch und absteigender Reihenfolge sortiert). </para> </refsect1> @@ -835,15 +865,15 @@ </funcprototype> </funcsynopsis> <para> - <function>array_pad</function> liefert eine Kopie von - <parameter>input</parameter>, welche auf die von - <parameter>pad_size</parameter> spezifizierte Größe mit dem Wert - <parameter>pad_value</parameter> erweitert wurde. Ist der Parameter - <parameter>pad_size</parameter> positiv, wird das Array rechts - erweitert, ist er negativ, dann erfolgt die Erweiterung links. Ist - der absolute Wert von <parameter>pad_size</parameter> kleiner oder - gleich der Länge von <parameter>input</parameter>, erfolgt keine - Erweiterung. + <function>array_pad</function> liefert eine Kopie von + <parameter>input</parameter>, welche auf die von + <parameter>pad_size</parameter> spezifizierte Größe mit dem Wert + <parameter>pad_value</parameter> erweitert wurde. Ist der + Parameter <parameter>pad_size</parameter> positiv, wird das Array + rechts erweitert, ist er negativ, dann erfolgt die Erweiterung + links. Ist der absolute Wert von <parameter>pad_size</parameter> + kleiner oder gleich der Länge von <parameter>input</parameter>, + erfolgt keine Erweiterung. </para> <para> <example> @@ -879,10 +909,11 @@ </funcprototype> </funcsynopsis> <para> - <function>array_pop</function> liefert den letzten Wert von - <parameter>array</parameter>, und verkürzt <parameter>array</parameter> - um ein Element. Ist <parameter>array</parameter> leer (oder kein Array), - wird &null; zurückgegeben. + <function>array_pop</function> liefert den letzten Wert von + <parameter>array</parameter>, und verkürzt + <parameter>array</parameter> um ein Element. Ist + <parameter>array</parameter> leer (oder kein Array), wird &null; + zurückgegeben. </para> <para> <example> @@ -926,11 +957,12 @@ </funcprototype> </funcsynopsis> <para> - <function>array_push</function> behandelt - <parameter>array</parameter> als Stapel (Stack), und fügt die - übergebenen Variablen an das Ende von <parameter>array</parameter>. - Die Länge von <parameter>array</parameter> wird dabei um die Anzahl - der angefügten Variablen erhöht. Dies hat den selben Effekt wie: + <function>array_push</function> behandelt + <parameter>array</parameter> als Stapel (Stack), und fügt die + übergebenen Variablen an das Ende von + <parameter>array</parameter>. Die Länge von + <parameter>array</parameter> wird dabei um die Anzahl der + angefügten Variablen erhöht. Dies hat den selben Effekt wie: <programlisting role="php"> $array[] = $var; </programlisting> @@ -979,23 +1011,24 @@ </funcprototype> </funcsynopsis> <para> - <function>array_rand</function> ist ziemlich nützlich, wenn Sie einen - oder mehrere zufällige Einträge eines Arrays auswählen möchten. Die - Funktion übernimmt das Array <parameter>input</parameter>, und ein - optionales Argument <parameter>num_req</parameter>, welches die - gewünschte Anzahl Einträge spezifiziert. Ist - <parameter>num_req</parameter> nicht angegeben, wird ein Defaultwert - von 1 angenommen. - </para> - <para> - Wenn Sie nur einen Eintrag auswählen, liefert - <function>array_rand</function> den Schlüssel eines zufälligen Eintrages. - Andernfalls wird ein Array mit den Schlüsseln der zufälligen Einträge - zurückgegeben. Dies hat den Zweck, dass Sie zufällige Schlüssel und auch - Werte aus dem Array auswählen können. + <function>array_rand</function> ist ziemlich nützlich, wenn Sie + einen oder mehrere zufällige Einträge eines Arrays auswählen + möchten. Die Funktion übernimmt das Array + <parameter>input</parameter>, und ein optionales Argument + <parameter>num_req</parameter>, welches die gewünschte Anzahl + Einträge spezifiziert. Ist <parameter>num_req</parameter> nicht + angegeben, wird ein Defaultwert von 1 angenommen. + </para> + <para> + Wenn Sie nur einen Eintrag auswählen, liefert + <function>array_rand</function> den Schlüssel eines zufälligen + Eintrages. Andernfalls wird ein Array mit den Schlüsseln der + zufälligen Einträge zurückgegeben. Dies hat den Zweck, dass Sie + zufällige Schlüssel und auch Werte aus dem Array auswählen + können. </para> <para> - Vergessen Sie bitte nicht, mittels <function>srand</function> den + Vergessen Sie bitte nicht, mittels <function>srand</function> den Startwert für den Zufallsgenerator festzulegen. </para> <para> @@ -1026,14 +1059,17 @@ <funcprototype> <funcdef>array <function>array_reverse</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> - <paramdef>bool <parameter><optional>preserve_keys</optional></parameter></paramdef> + <paramdef>bool + <parameter><optional>preserve_keys</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> - <function>array_reverse</function> liefert ein Array mit der umgekehrten - Reihenfolge der Elemente von <parameter>array</parameter>. Ist der - optionale Parameter <parameter>preserve_keys</parameter> - &true;, bleibt die Reihenfolge der Schlüssel aufrecht. + <function>array_reverse</function> liefert ein Array mit der + umgekehrten Reihenfolge der Elemente von + <parameter>array</parameter>. Ist der optionale Parameter + <parameter>preserve_keys</parameter> &true;, bleibt die + Reihenfolge der Schlüssel aufrecht. </para> <para> <example> @@ -1046,9 +1082,11 @@ </example> </para> <para> - Dies speichert in <varname>$result</varname> und <varname>$result_keyed</varname> - <literal>array(array ("green", "red"), 4.0, "php")</literal>, allerdings ist - <varname>$result_keyed[0]</varname> noch immer <literal>"php"</literal>. + Dies speichert in <varname>$result</varname> und + <varname>$result_keyed</varname> <literal>array(array ("green", + "red"), 4.0, "php")</literal>, allerdings ist + <varname>$result_keyed[0]</varname> noch immer + <literal>"php"</literal>. </para> <note> <para> @@ -1062,7 +1100,8 @@ <refnamediv> <refname>array_reduce</refname> <refpurpose> - Iterative Reduktion eines Arrays zu einem Wert mittels einer Callback Funktion + Iterative Reduktion eines Arrays zu einem Wert mittels einer + Callback Funktion </refpurpose> </refnamediv> <refsect1> @@ -1078,25 +1117,26 @@ </funcprototype> </funcsynopsis> <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 + <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. </para> <para> <example> <title><function>array_reduce</function></title> <programlisting role="php"> function rsum($v, $w) { - $v += $w; - return $v; + $v += $w; + return $v; } function rmul($v, $w) { - $v *= $w; - return $v; + $v *= $w; + return $v; } $a = array(1, 2, 3, 4, 5); @@ -1195,14 +1235,14 @@ <parameter>array</parameter>. </para> <para> - Ist <parameter>length</parameter> positiv, enthält die Sequenz - genauso viele Elemente. Ist <parameter>length</parameter> negativ, - enthält die Sequenz alle Elemente des Arrays von - <parameter>offset</parameter> bis <parameter>length</parameter> - Elemente vor dem Ende des Arrays. Ist <parameter>length</parameter> - nicht angegeben, enthält die Sequenz alle Elemente von - <parameter>offset</parameter> bis zum Ende von - <parameter>array</parameter>. + Ist <parameter>length</parameter> positiv, enthält die Sequenz + genauso viele Elemente. Ist <parameter>length</parameter> + negativ, enthält die Sequenz alle Elemente des Arrays von + <parameter>offset</parameter> bis <parameter>length</parameter> + Elemente vor dem Ende des Arrays. Ist + <parameter>length</parameter> nicht angegeben, enthält die + Sequenz alle Elemente von <parameter>offset</parameter> bis zum + Ende von <parameter>array</parameter>. </para> <para> <example> @@ -1227,7 +1267,8 @@ <refnamediv> <refname>array_splice</refname> <refpurpose> - Entfernt einen Teil eines Arrays und ersetzt ihn durch etwas anderes + Entfernt einen Teil eines Arrays und ersetzt ihn durch etwas + anderes </refpurpose> </refnamediv> <refsect1> @@ -1248,41 +1289,43 @@ </funcprototype> </funcsynopsis> <para> - <function>array_splice</function> entfernt die durch - <parameter>offset</parameter> und <parameter>length</parameter> - angegebenen Elemente des Arrays <parameter>input</parameter>, und - ersetzt diese durch die Elemente des Arrays + <function>array_splice</function> entfernt die durch + <parameter>offset</parameter> und <parameter>length</parameter> + angegebenen Elemente des Arrays <parameter>input</parameter>, und + ersetzt diese durch die Elemente des Arrays <parameter>replacement</parameter>, wenn angegeben. </para> <para> - Ist <parameter>offset</parameter> positiv, beginnt der zu - entfernende Bereich bei diesem Offset vom Anfang des Arrays - <parameter>input</parameter>. Ist <parameter>offset</parameter> - negativ, beginnt der zu entfernende Bereich - <parameter>offset</parameter> Elemente vor dem Ende des Arrays - <parameter>input</parameter>. - </para> - <para> - Ist <parameter>length</parameter> nicht angegeben, wird alles von - <parameter>offset</parameter> bis zum Ende des Arrays entfernt. Ist - <parameter>length</parameter> positiv, wird die angegebene Anzahl - Elemente entfernt. Ist <parameter>length</parameter> negativ, dann - wird der Bereich von <parameter>length</parameter> Elementen - vor dem Ende, bis zum Ende des Arrays entfernt. Tipp: Um alles von - <parameter>offset</parameter> bis zum Ende des Arrays zu entfernen - wenn <parameter>replacement</parameter> ebenfalls angegeben ist, - verwenden Sie <literal>count($input)</literal> als + Ist <parameter>offset</parameter> positiv, beginnt der zu + entfernende Bereich bei diesem Offset vom Anfang des Arrays + <parameter>input</parameter>. Ist <parameter>offset</parameter> + negativ, beginnt der zu entfernende Bereich + <parameter>offset</parameter> Elemente vor dem Ende des Arrays + <parameter>input</parameter>. + </para> + <para> + Ist <parameter>length</parameter> nicht angegeben, wird alles von + <parameter>offset</parameter> bis zum Ende des Arrays + entfernt. Ist <parameter>length</parameter> positiv, wird die + angegebene Anzahl Elemente entfernt. Ist + <parameter>length</parameter> negativ, dann wird der Bereich von + <parameter>length</parameter> Elementen vor dem Ende, bis zum + Ende des Arrays entfernt. Tipp: Um alles von + <parameter>offset</parameter> bis zum Ende des Arrays zu + entfernen wenn <parameter>replacement</parameter> ebenfalls + angegeben ist, verwenden Sie <literal>count($input)</literal> als <parameter>length</parameter>. </para> <para> - Ist das Array <parameter>replacement</parameter> angegeben, werden - die entfernten Elemente durch die Elemente dieses Arrays ersetzt. Sind - <parameter>offset</parameter> und <parameter>length</parameter> so - angegeben dass nichts entfernt wird, werden die Elemente von - <parameter>replacement</parameter> an der von - <parameter>offset</parameter> spezifizierten Stelle eingefügt. Tip: - Soll die Ersetzung durch nur ein Element erfolgen ist es nicht nötig - ein Array zu anzugeben es sei denn, dieses Element ist selbst ein Array. + Ist das Array <parameter>replacement</parameter> angegeben, + werden die entfernten Elemente durch die Elemente dieses Arrays + ersetzt. Sind <parameter>offset</parameter> und + <parameter>length</parameter> so angegeben dass nichts entfernt + wird, werden die Elemente von <parameter>replacement</parameter> + an der von <parameter>offset</parameter> spezifizierten Stelle + eingefügt. Tip: Soll die Ersetzung durch nur ein Element erfolgen + ist es nicht nötig ein Array zu anzugeben es sei denn, dieses + Element ist selbst ein Array. </para> <para> Hier einige Entsprechungen: @@ -1376,14 +1419,15 @@ </funcprototype> </funcsynopsis> <para> - <function>array_unique</function> nimmt <parameter>array</parameter> - und gibt ein neues Array zurück, aus dem alle doppelten Einträge - entfernt wurden. + <function>array_unique</function> nimmt + <parameter>array</parameter> und gibt ein neues Array zurück, aus + dem alle doppelten Einträge entfernt wurden. </para> <para> Beachten Sie, dass Schlüssel erhalten bleiben. - <function>array_unique</function> erhält den ersten gefundenen Schlüssel, - für jeden Wert, und ignoriert alle folgenden Schlüssel. + <function>array_unique</function> erhält den ersten gefundenen + Schlüssel, für jeden Wert, und ignoriert alle folgenden + Schlüssel. </para> <para> <example> @@ -1403,10 +1447,10 @@ </example> </para> <para> - Beachten Sie, dass <function>array_unique</function> den Typ des Wertes - berücksichtigt. Dies ist normalerweise nicht so wichtig, außer wenn - Zahlen verglichen werden, welche unterschiedlichen Typs sein können. - Dies könnte zu vewirrenden Ergebnissen führen: + Beachten Sie, dass <function>array_unique</function> den Typ des + Wertes berücksichtigt. Dies ist normalerweise nicht so wichtig, + außer wenn Zahlen verglichen werden, welche unterschiedlichen + Typs sein können. Dies könnte zu vewirrenden Ergebnissen führen: </para> <para> <example> @@ -1451,14 +1495,14 @@ </funcprototype> </funcsynopsis> <para> - <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. + <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. </para> <para> - Diese Funktion gibt die neue Anzahl der in <parameter>array</parameter> - enthaltenen Elemente zurück. + Diese Funktion gibt die neue Anzahl der in + <parameter>array</parameter> enthaltenen Elemente zurück. </para> <para> <example> @@ -1509,12 +1553,12 @@ </para> <note> <para> - Diese Funktion wurde in PHP 4 hinzugefügt, nachstehend findet sich - eine Implementation für Benutzer von PHP 3. + Diese Funktion wurde in PHP 4 hinzugefügt, nachstehend findet + sich eine Implementation für Benutzer von PHP 3. <example> <title> - Implementation von <function>array_values</function> für PHP 3 - Benutzer + Implementation von <function>array_values</function> für PHP 3 + Benutzer </title> <programlisting role="php"> function array_values ($arr) { @@ -1549,45 +1593,48 @@ </funcprototype> </funcsynopsis> <simpara> - Wendet die mittels <parameter>func</parameter> angegebene - Benutzerfunktion für jedes Element von <parameter>arr</parameter> - an. <parameter>func</parameter> wird der Wert als erster, und der - Schlüssel als zweiter Parameter übergeben. Sofern angegeben, wird - <parameter>userdata</parameter>, als dritter Parameter an die + Wendet die mittels <parameter>func</parameter> angegebene + Benutzerfunktion für jedes Element von <parameter>arr</parameter> + an. <parameter>func</parameter> wird der Wert als erster, und der + Schlüssel als zweiter Parameter übergeben. Sofern angegeben, wird + <parameter>userdata</parameter>, als dritter Parameter an die Funktion <parameter>func</parameter> übergeben. - <parameter>func</parameter> muss eine vom Benutzer definierte - Funktion sein, und nicht eine native PHP Funktion. Deshalb können - Sie <function>array_walk</function> nicht direkt mit + <parameter>func</parameter> muss eine vom Benutzer definierte + Funktion sein, und nicht eine native PHP Funktion. Deshalb können + Sie <function>array_walk</function> nicht direkt mit <function>str2lower</function> benutzen, sondern müssen erst eine - eigene Funktion damit erstellen, und diese Funktion als Argument + eigene Funktion damit erstellen, und diese Funktion als Argument übergeben. </simpara> <simpara> - Sollte <parameter>func</parameter> mehr als zwei oder drei Argumente - verlangen, wird - abhängig von <parameter>userdata</parameter> - - bei jedem Aufruf von <parameter>func</parameter> seitens - <function>array_walk</function> eine Warnmeldung generiert. Diese - Warnmeldungen können unterdrückt werden, indem man dem Funktionsaufruf - von <function>array_walk</function> ein '@' Zeichen voranstellt, oder - mittels der Verwendung von <function>error_reporting</function>. + Sollte <parameter>func</parameter> mehr als zwei oder drei + Argumente verlangen, wird - abhängig von + <parameter>userdata</parameter> - bei jedem Aufruf von + <parameter>func</parameter> seitens + <function>array_walk</function> eine Warnmeldung generiert. Diese + Warnmeldungen können unterdrückt werden, indem man dem + Funktionsaufruf von <function>array_walk</function> ein '@' + Zeichen voranstellt, oder mittels der Verwendung von + <function>error_reporting</function>. </simpara> <note> <para> - Wenn <parameter>func</parameter> mit den Werten des Arrays direkt - arbeiten soll, geben Sie an, dass der erste Parameter von - <parameter>func</parameter> als Referenz übergeben werden muss. - Dann werden alle Änderungen an diesen Elementen direkt in dem + Wenn <parameter>func</parameter> mit den Werten des Arrays + direkt arbeiten soll, geben Sie an, dass der erste Parameter von + <parameter>func</parameter> als Referenz übergeben werden muss. + Dann werden alle Änderungen an diesen Elementen direkt in dem selbst durchgeführt. </para> </note> <note> <para> - Die Übergabe des Schlüssels und von <parameter>userdata</parameter> - an <parameter>func</parameter> wurde mit PHP 4.0 eingeführt. + Die Übergabe des Schlüssels und von + <parameter>userdata</parameter> an <parameter>func</parameter> + wurde mit PHP 4.0 eingeführt. </para> <para> - In PHP 4 muss <function>reset</function> aufgerufen werden, da - <function>array_walk</function> den internen Zeiger nicht + In PHP 4 muss <function>reset</function> aufgerufen werden, da + <function>array_walk</function> den internen Zeiger nicht selbsttätig wieder auf das erste Element zurücksetzt. </para> </note> @@ -1614,7 +1661,8 @@ </example> </para> <simpara> - Siehe auch <function>each</function> und <function>list</function>. + Siehe auch <function>each</function> und + <function>list</function>. </simpara> </refsect1> </refentry> @@ -1623,8 +1671,8 @@ <refnamediv> <refname>arsort</refname> <refpurpose> - Sortiert ein Array in umgekehrter Reihenfolge und behält die Index - Assotiation bei + Sortiert ein Array in umgekehrter Reihenfolge und behält die + Verbindung zum Index </refpurpose> </refnamediv> <refsect1> @@ -1669,17 +1717,19 @@ </informalexample> </para> <para> - Die Früchte wurden in umgekehrter alphabetischer Reihenfolge sortiert, - und die Zuordnung zwischen Index und Element blieb beibehalten. + Die Früchte wurden in umgekehrter alphabetischer Reihenfolge + sortiert, und die Zuordnung zwischen Index und Element blieb + beibehalten. </para> <para> - Sie können das Verhalten der Sortierung mittels dem optionalen - Parameter <parameter>sort_flags</parameter> beeinflussen, für Details - siehe <function>sort</function>. + Sie können das Verhalten der Sortierung mittels dem optionalen + Parameter <parameter>sort_flags</parameter> beeinflussen, für + Details siehe <function>sort</function>. </para> <para> - Siehe auch: <function>asort</function>, <function>rsort</function>, - <function>ksort</function>, und <function>sort</function>. + Siehe auch: <function>asort</function>, + <function>rsort</function>, <function>ksort</function>, und + <function>sort</function>. </para> </refsect1> </refentry> @@ -1688,7 +1738,7 @@ <refnamediv> <refname>asort</refname> <refpurpose> - Sortiert ein Array und behält Indexverbindungen bei + Sortiert ein Array und behält die Indexverbindungen </refpurpose> </refnamediv> <refsect1> @@ -1697,14 +1747,17 @@ <funcprototype> <funcdef>void <function>asort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> - <paramdef>int <parameter><optional>sort_flags</optional></parameter></paramdef> + <paramdef>int + <parameter><optional>sort_flags</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> - Diese Funktion sortiert ein Array so, dass der Zusammenhang zwischen - den Indizes und den entsprechenden Arrayelementen erhalten bleibt. - Dies wird hauptsächlich bei assoziativen Arrays verwendet, bei denen - die aktuelle Reihenfolge der Elemente bedeutend ist. + Diese Funktion sortiert ein Array so, dass der Zusammenhang + zwischen den Indizes und den entsprechenden Arrayelementen + erhalten bleibt. Dies wird hauptsächlich bei assoziativen Arrays + verwendet, bei denen die aktuelle Reihenfolge der Elemente + bedeutend ist. <example> <title><function>asort</function> example</title> <programlisting role="php"> @@ -1731,17 +1784,18 @@ </informalexample> </para> <para> - Die Früchte wurden alphabetisch sortiert, und die Zuordnung zwischen - Index und Element blieb beibehalten + Die Früchte wurden alphabetisch sortiert, und die Zuordnung + zwischen Index und Element blieb beibehalten </para> <para> - Sie können das Verhalten der Sortierung mittels dem optionalen - Parameter <parameter>sort_flags</parameter> beeinflussen, für Details - siehe <function>sort</function>. + Sie können das Verhalten der Sortierung mittels dem optionalen + Parameter <parameter>sort_flags</parameter> beeinflussen, für + Details siehe <function>sort</function>. </para> <para> - Siehe auch <function>arsort</function>, <function>rsort</function>, - <function>ksort</function>, und <function>sort</function>. + Siehe auch <function>arsort</function>, + <function>rsort</function>, <function>ksort</function>, und + <function>sort</function>. </para> </refsect1> </refentry> @@ -1765,19 +1819,20 @@ </funcprototype> </funcsynopsis> <para> - <function>compact</function> übernimmt eine variable Anzahl von - Parametern. Jeder Parameter kann entweder ein String mit einem - Variablennamen, oder ein Array mit Variablennamen sein. Dieses - Array kann auch andere Arrays mit Variablennamen enthalten; + <function>compact</function> übernimmt eine variable Anzahl von + Parametern. Jeder Parameter kann entweder ein String mit einem + Variablennamen, oder ein Array mit Variablennamen sein. Dieses + Array kann auch andere Arrays mit Variablennamen enthalten; <function>compact</function> behandelt sie rekursiv. </para> <para> - Für alle diese sucht <function>compact</function> nach einer - Variablen in der aktuellen Symboltabelle, und fügt diese dem - zurückzugebenden Array hinzu, wobei der Variablenname als Schlüssel, - und der Inhalt der Variablen als Wert gespeichert wird. Kurz, diese - Funktion tut das Gegenteil von <function>extract</function>. Sie - gibt ein Array mit allen Variablen zurück. + Für alle diese sucht <function>compact</function> nach einer + Variablen in der aktuellen Symboltabelle, und fügt diese dem + zurückzugebenden Array hinzu, wobei der Variablenname als + Schlüssel, und der Inhalt der Variablen als Wert gespeichert + wird. Kurz, diese Funktion tut das Gegenteil von + <function>extract</function>. Sie gibt ein Array mit allen + Variablen zurück. </para> <para> Strings, welche nicht gesetzt sind, werden einfach ignoriert. @@ -1795,8 +1850,8 @@ $result = compact ("event", "nothing_here", $location_vars); </programlisting> <para> - Hier wird <literal>array ("event" =&gt; "SIGGRAPH", "city" =&gt; - "San Francisco", "state" =&gt; "CA")</literal> in + Hier wird <literal>array ("event" =&gt; "SIGGRAPH", "city" + =&gt; "San Francisco", "state" =&gt; "CA")</literal> in <varname>$result</varname> gespeichert. </para> </example> @@ -1821,14 +1876,16 @@ </funcprototype> </funcsynopsis> <para> - Liefert die Anzahl von Elementen in <parameter>var</parameter>, welche - typischerweise ein Array ist (da alles andere ein Element enthält). + Liefert die Anzahl von Elementen in <parameter>var</parameter>, + welche typischerweise ein Array ist (da alles andere ein Element + enthält). </para> <para> Gibt 1 zurück, wenn die Variable kein Array ist. </para> <para> - Gibt 0 zurück, wenn die Variable nicht gesetzt, oder ein leeres Array ist. + Gibt 0 zurück, wenn die Variable nicht gesetzt, oder ein leeres + Array ist. <warning> <para> <function>count</function> kann 0 zurückgeben wenn die Variable @@ -1841,8 +1898,8 @@ </para> <para> In der Sektion <link linkend="language.types.array">Arrays</link> - finden Sie eine detailierte Erklärung, wie Arrays in PHP implementiert - sind und wie sie benutzt werden. + finden Sie eine detailierte Erklärung, wie Arrays in PHP + implementiert sind und wie sie benutzt werden. </para> <para> <example> @@ -1862,15 +1919,15 @@ </programlisting> </example> </para> - <note> - <para> + <note> + <para> Die Funktion <function>sizeof</function> ist ein Alias für <function>count</function>. - </para> - </note> + </para> + </note> <para> Siehe auch: <function>sizeof</function>, - <function>isset</function>, und + <function>isset</function> und <function>is_array</function>. </para> </refsect1> @@ -1890,31 +1947,31 @@ </funcprototype> </funcsynopsis> <para> - Jedes Array hat einen internen Zeiger auf sein "aktuelles" Element, - welcher auf das erste in das Array eingefügte Element initialisiert - wird. + Jedes Array hat einen internen Zeiger auf sein "aktuelles" + Element, welcher auf das erste in das Array eingefügte Element + initialisiert wird. </para> <para> - Die Funktion <function>current</function> liefert das Array Element, - auf das gerade vom internen Zeiger gezeigt wird. Sie bewegt den Zeiger - in keinster Weise. Zeigt der interne Zeiger hinter das Ende der - Elementenliste, gibt <function>current</function> - &false; zurück. + Die Funktion <function>current</function> liefert das Array + Element, auf das gerade vom internen Zeiger gezeigt wird. Sie + bewegt den Zeiger in keinster Weise. Zeigt der interne Zeiger + hinter das Ende der Elementenliste, gibt + <function>current</function> &false; zurück. <warning> <para> - Enthält das Array leere Elemente (0 oder "", den leeren String), - gibt diese Funktion auch für diese Elemente &false; - zurück. Das macht es unmöglich, unter Verwendung von - <function>current</function> herauszufinden, ob das wirklich am - Ende der Liste sind. Um ein Array, das leere Elemente enthalten - könnte richtig durchzugehen, verwenden Sie die Funktion + Enthält das Array leere Elemente (0 oder "", den leeren + String), gibt diese Funktion auch für diese Elemente &false; + zurück. Das macht es unmöglich, unter Verwendung von + <function>current</function> herauszufinden, ob das wirklich am + Ende der Liste sind. Um ein Array, das leere Elemente enthalten + könnte richtig durchzugehen, verwenden Sie die Funktion <function>each</function>. </para> </warning> </para> <para> Siehe auch: <function>end</function>, <function>next</function>, - <function>prev</function>, und <function>reset</function>. + <function>prev</function> und <function>reset</function>. </para> </refsect1> </refentry> @@ -1935,17 +1992,17 @@ </funcprototype> </funcsynopsis> <para> - Liefert das aktuelle Schlüssel- Wertepaar des Arrays - <parameter>array</parameter>, und erhöht den Array Cursor. Dieses - Paar wird als Array mit 4 Elementen zurückgegeben, und zwar mit den - Schlüsseln <emphasis>0</emphasis>, <emphasis>1</emphasis>, - <emphasis>key</emphasis>, and <emphasis>value</emphasis>. Die Elemente - <emphasis>0</emphasis> und <emphasis>key</emphasis> enthalten den Namen - des Schlüssels, <emphasis>1</emphasis> and <emphasis>value</emphasis> - den Wert. + Liefert das aktuelle Schlüssel- Wertepaar des Arrays + <parameter>array</parameter>, und erhöht den Array Cursor. Dieses + Paar wird als Array mit 4 Elementen zurückgegeben, und zwar mit + den Schlüsseln <emphasis>0</emphasis>, <emphasis>1</emphasis>, + <emphasis>key</emphasis>, and <emphasis>value</emphasis>. Die + Elemente <emphasis>0</emphasis> und <emphasis>key</emphasis> + enthalten den Namen des Schlüssels, <emphasis>1</emphasis> and + <emphasis>value</emphasis> den Wert. </para> <para> - Zeigt der interne Zeiger hinter das Ende der Array-Inhalte, gibt + Zeigt der interne Zeiger hinter das Ende der Array-Inhalte, gibt <function>each</function> &false; zurück. </para> <para> @@ -2007,7 +2064,7 @@ <para> Siehe auch <function>key</function>, <function>list</function>, <function>current</function>, <function>reset</function>, - <function>next</function>, und <function>prev</function>. + <function>next</function> und <function>prev</function>. </para> </refsect1> </refentry> @@ -2035,7 +2092,7 @@ <para> Siehe auch: <function>current</function>, <function>each</function>, <function>end</function>, - <function>next</function>, und <function>reset</function>. + <function>next</function> und <function>reset</function>. </para> </refsect1> </refentry> @@ -2062,27 +2119,28 @@ </funcprototype> </funcsynopsis> <para> - Diese Funktion wird verwendet, um Variablen eines Arrays in die - aktuelle Symboltabelle zu importieren. Es behandelt die Schlüssel des - assoziativen Arrays <parameter>var_array</parameter> als Variablennamen, - und die Werte als Variablenwerte. Für jedes Paar Schlüssel/Wert wird - - abhängig von den Parametern <parameter>extract_type</parameter> und - <parameter>prefix</parameter> - eine Variable in der aktuellen + Diese Funktion wird verwendet, um Variablen eines Arrays in die + aktuelle Symboltabelle zu importieren. Es behandelt die Schlüssel + des assoziativen Arrays <parameter>var_array</parameter> als + Variablennamen, und die Werte als Variablenwerte. Für jedes Paar + Schlüssel/Wert wird - abhängig von den Parametern + <parameter>extract_type</parameter> und + <parameter>prefix</parameter> - eine Variable in der aktuellen Symboltabelle eingetragen. </para> <note> <para> - Seit Version 4.0.5 gibt diese Funktion die Anzahl der extrahierten - Variablen zurück. + Seit Version 4.0.5 gibt diese Funktion die Anzahl der + extrahierten Variablen zurück. </para> </note> <para> - <function>extract</function> prüft jeden Schlüssel, ob dieser einen - gültigen Variablennamen ergibt, und auch auf eventuelle Kollisionen - mit existierenden Variablen in der Symboltabelle. Die Art, wie - ungültige/numerische Schlüssel und Kollisionen behandelt werden, wird - mit <parameter>extract_type</parameter> spezifiziert. Es kann einen der - folgenden Werte annehmen: + <function>extract</function> prüft jeden Schlüssel, ob dieser + einen gültigen Variablennamen ergibt, und auch auf eventuelle + Kollisionen mit existierenden Variablen in der Symboltabelle. Die + Art, wie ungültige/numerische Schlüssel und Kollisionen behandelt + werden, wird mit <parameter>extract_type</parameter> + spezifiziert. Es kann einen der folgenden Werte annehmen: <variablelist> <varlistentry> <term>EXTR_OVERWRITE</term> @@ -2114,8 +2172,9 @@ <term>EXTR_PREFIX_ALL</term> <listitem> <simpara> - Allen Variablennamen wird <parameter>prefix</parameter> vorangestellt. - Seit PHP 4.0.5 gilt dies auch für numerische Schlüssel. + Allen Variablennamen wird <parameter>prefix</parameter> + vorangestellt. Seit PHP 4.0.5 gilt dies auch für numerische + Schlüssel. </simpara> </listitem> </varlistentry> @@ -2123,9 +2182,9 @@ <term>EXTR_PREFIX_INVALID</term> <listitem> <simpara> - Nur ungültigen/numerischen Variablennamen wird - <parameter>prefix</parameter> vorangestellt. Dieser Flag wurde - mit PHP 4.0.5 eingeführt. + Nur ungültigen/numerischen Variablennamen wird + <parameter>prefix</parameter> vorangestellt. Dieser Flag + wurde mit PHP 4.0.5 eingeführt. </simpara> </listitem> </varlistentry> @@ -2136,11 +2195,11 @@ EXTR_OVERWRITE angenommen. </para> <para> - Beachten Sie, dass <parameter>prefix</parameter> nur dann nötig ist, - wenn <parameter>extract_type</parameter> EXTR_PREFIX_SAME, - EXTR_PREFIX_ALL, oder EXTR_PREFIX_INVALID ist. Ist das Resultat trotz - Präfix kein gültiger Variablenname, wird es nicht in die Symboltabelle - importiert. + Beachten Sie, dass <parameter>prefix</parameter> nur dann nötig + ist, wenn <parameter>extract_type</parameter> EXTR_PREFIX_SAME, + EXTR_PREFIX_ALL, oder EXTR_PREFIX_INVALID ist. Ist das Resultat + trotz Präfix kein gültiger Variablenname, wird es nicht in die + Symboltabelle importiert. </para> <para> <function>extract</function> gibt die Anzahl erfolgreich in die @@ -2179,18 +2238,19 @@ </programlisting> </para> <para> - <varname>$size</varname> wurde nicht überschrieben, da wir + <varname>$size</varname> wurde nicht überschrieben, da wir EXTR_PREFIX_SAME spezifiziert haben, was im Anlegen von <varname>$wddx_size</varname> endete. Wäre EXTR_SKIP spezifiziert - worden, dann wäre $wddx_size nicht angelegt worden. EXTR_OVERWRITE - hätte <varname>$size</varname> mit dem Wert "medium" - überschrieben, und EXTR_PREFIX_ALL hätte die neuen Variablen - <varname>$wddx_color</varname>, <varname>$wddx_size</varname>, - und <varname>$wddx_shape</varname> angelegt. + worden, dann wäre $wddx_size nicht angelegt + worden. EXTR_OVERWRITE hätte <varname>$size</varname> mit dem + Wert "medium" überschrieben, und EXTR_PREFIX_ALL hätte die neuen + Variablen <varname>$wddx_color</varname>, + <varname>$wddx_size</varname>, und <varname>$wddx_shape</varname> + angelegt. </para> <para> - Sie müssen assoziative Arrays benutzen, numerisch indizierte Arrays - liefern keine Resultate. + Sie müssen assoziative Arrays benutzen, numerisch indizierte + Arrays liefern keine Resultate. </para> <para> Siehe auch: <function>compact</function>. @@ -2201,7 +2261,9 @@ <refentry id="function.in-array"> <refnamediv> <refname>in_array</refname> - <refpurpose>Prüft, ob ein Wert in einem Array existiert</refpurpose> + <refpurpose> + Prüft, ob ein Wert in einem Array existiert + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -2216,24 +2278,23 @@ </funcprototype> </funcsynopsis> <para> - Diese Funktion sucht in <parameter>haystack</parameter> nach - <parameter>needle</parameter> und gibt bei Erfolg &true; zurück, + Diese Funktion sucht in <parameter>haystack</parameter> nach + <parameter>needle</parameter> und gibt bei Erfolg &true; zurück, andernfalls &false;. </para> <para> - Ist der dritte Parameter <parameter>strict</parameter> auf - &true; gesetzt, prüft <function>in_array</function> - auch die Typen von <parameter>needle</parameter> in - <parameter>haystack</parameter>. + Ist der dritte Parameter <parameter>strict</parameter> auf &true; + gesetzt, prüft <function>in_array</function> auch die Typen von + <parameter>needle</parameter> in <parameter>haystack</parameter>. </para> <para> <example> <title><function>in_array</function></title> <programlisting role="php"> $os = array ("Mac", "NT", "Irix", "Linux"); -if (in_array ("Irix", $os)){ +if (in_array ("Irix", $os)) { print "Irix gefunden"; - } +} </programlisting> </example> </para> @@ -2266,7 +2327,8 @@ <refnamediv> <refname>array_search</refname> <refpurpose> - Durchsucht ein Array nach einem Wert liefert bei Erfolg den Schlüssel + Durchsucht ein Array nach einem Wert liefert bei Erfolg den + Schlüssel </refpurpose> </refnamediv> <refsect1> @@ -2299,7 +2361,9 @@ <refentry id="function.key"> <refnamediv> <refname>key</refname> - <refpurpose>Liefert einen Schlüssel eines assoziativen Arrays</refpurpose> + <refpurpose> + Liefert einen Schlüssel eines assoziativen Arrays + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -2310,11 +2374,12 @@ </funcprototype> </funcsynopsis> <para> - <function>key</function> liefert das Index Element der aktuellen + <function>key</function> liefert das Index Element der aktuellen Position im Array. </para> <para> - Siehe auch: <function>current</function> und <function>next</function>. + Siehe auch: <function>current</function> und + <function>next</function>. </para> </refsect1> </refentry> @@ -2322,7 +2387,8 @@ <refentry id="function.krsort"> <refnamediv> <refname>krsort</refname> - <refpurpose>Sortiert ein Array nach Schlüsseln in umgekehrter Reihenfolge + <refpurpose> + Sortiert ein Array nach Schlüsseln in umgekehrter Reihenfolge </refpurpose> </refnamediv> <refsect1> @@ -2337,9 +2403,10 @@ </funcprototype> </funcsynopsis> <para> - Sortiert ein Array nach Schlüsseln in umgekehrter Reihenfolge, wobei - die Zuordnungen zwischen Schlüssel und Wert erhalten bleiben. Dies ist - hauptsächlich bei assoziativen Arrays hilfreich. + Sortiert ein Array nach Schlüsseln in umgekehrter Reihenfolge, + wobei die Zuordnungen zwischen Schlüssel und Wert erhalten + bleiben. Dies ist hauptsächlich bei assoziativen Arrays + hilfreich. <example> <title><function>krsort</function></title> <programlisting role="php"> @@ -2366,14 +2433,15 @@ </informalexample> </para> <para> - Sie können das Verhalten der Sortierung mittels dem optionalen - Parameter <parameter>sort_flags</parameter> beeinflussen, für Details - siehe <function>sort</function>. + Sie können das Verhalten der Sortierung mittels dem optionalen + Parameter <parameter>sort_flags</parameter> beeinflussen, für + Details siehe <function>sort</function>. </para> <simpara> - Siehe auch: <function>asort</function>, <function>arsort</function>, - <function>ksort</function> <function>sort</function>, - <function>natsort</function> und <function>rsort</function>. + Siehe auch: <function>asort</function>, + <function>arsort</function>, <function>ksort</function> + <function>sort</function>, <function>natsort</function> und + <function>rsort</function>. </simpara> </refsect1> </refentry> @@ -2395,9 +2463,9 @@ </funcprototype> </funcsynopsis> <para> - Sortiert ein Array nach Schlüsseln, wobei die Zuordnungen zwischen - Schlüssel und Wert erhalten bleiben. Dies ist hauptsächlich bei - assoziativen Arrays hilfreich. + Sortiert ein Array nach Schlüsseln, wobei die Zuordnungen + zwischen Schlüssel und Wert erhalten bleiben. Dies ist + hauptsächlich bei assoziativen Arrays hilfreich. <example> <title><function>ksort</function></title> <programlisting role="php"> @@ -2424,14 +2492,14 @@ </informalexample> </para> <para> - Sie können das Verhalten der Sortierung mittels dem optionalen - Parameter <parameter>sort_flags</parameter> beeinflussen, für Details - siehe <function>sort</function>. + Sie können das Verhalten der Sortierung mittels dem optionalen + Parameter <parameter>sort_flags</parameter> beeinflussen, für + Details siehe <function>sort</function>. </para> <simpara> - Siehe auch: <function>asort</function>, <function>arsort</function>, - <function>sort</function>, <function>natsort</function>, und - <function>rsort</function>. + Siehe auch: <function>asort</function>, + <function>arsort</function>, <function>sort</function>, + <function>natsort</function> und <function>rsort</function>. </simpara> <note> <para> @@ -2457,10 +2525,10 @@ </funcprototype> </funcsynopsis> <para> - Wie <function>array</function> ist auch dies keine wirkliche - Funktion, sondern ein Sprachkonstrukt. <function>list</function> - wird verwendet, um eine Liste von Variablen innerhalb einer Operation - zuzuweisen. + Wie <function>array</function> ist auch dies keine wirkliche + Funktion, sondern ein Sprachkonstrukt. <function>list</function> + wird verwendet, um eine Liste von Variablen innerhalb einer + Operation zuzuweisen. <example> <title><function>list</function></title> <programlisting role="php"> @@ -2487,7 +2555,8 @@ </example> </para> <para> - Siehe auch: <function>each</function> und <function>array</function>. + Siehe auch: <function>each</function> und + <function>array</function>. </para> </refsect1> </refentry> @@ -2508,25 +2577,24 @@ </funcprototype> </funcsynopsis> <para> - Diese Funktion implementiert einen Sortieralgorithmus, welcher - alphanumerische Zeichenketten reiht, wie es auch ein Mensch tun - würde. Hier ein Beispiel für den Unterschied zwischen diesem und - dem normalen Sortieralgorithmus für Strings eines Computers + Diese Funktion implementiert einen Sortieralgorithmus, welcher + alphanumerische Zeichenketten reiht, wie es auch ein Mensch tun + würde. Hier ein Beispiel für den Unterschied zwischen diesem und + dem normalen Sortieralgorithmus für Strings eines Computers (verwendet in <function>sort</function>): </para> <para> <example> <title><function>natsort</function></title> <programlisting role="php"> -$array1 = $array2 = array ("img12.png","img10.png","img2.png","img1.png"); - -sort($array1); +$array1 = $array2 = array ("img12.png", "img10.png", "img2.png", "img1.png"); +sort ($array1); echo "Standard sorting\n"; -print_r($array1); +print_r ($array1); -natsort($array2); +natsort ($array2); echo "\nNatural order sorting\n"; -print_r($array2); +print_r ($array2); </programlisting> </example> </para> @@ -2571,7 +2639,8 @@ <refnamediv> <refname>natcasesort</refname> <refpurpose> - Sortiert ein Array in "natürlicher Reihenfolge", Groß/Kleinschreibung wird ignoriert + Sortiert ein Array in "natürlicher Reihenfolge", + Groß/Kleinschreibung wird ignoriert </refpurpose> </refnamediv> <refsect1> @@ -2583,16 +2652,16 @@ </funcprototype> </funcsynopsis> <para> - Diese Funktion implementiert einen Sortieralgorithmus, welcher - alphanumerische Zeichenketten reiht, wie es auch ein Mensch tun + Diese Funktion implementiert einen Sortieralgorithmus, welcher + alphanumerische Zeichenketten reiht, wie es auch ein Mensch tun würde. Das wird als "natürliche Reihenfolge" bezeichnet. </para> <para> - <function>natcasesort</function> arbeitet wie - <function>natsort</function>, nur dass es die Groß/Kleinschreibung - ignoriert. Ein Beispiel für den Unterschied zwischen diesem und - dem normalen Sortieralgorithmus für Strings eines Computers finden - Sie in <function>natsort</function>. + <function>natcasesort</function> arbeitet wie + <function>natsort</function>, nur dass es die + Groß/Kleinschreibung ignoriert. Ein Beispiel für den Unterschied + zwischen diesem und dem normalen Sortieralgorithmus für Strings + eines Computers finden Sie in <function>natsort</function>. </para> <para> Detailliertere Informationen finden Sie auf Martin Pool's <ulink @@ -2601,8 +2670,7 @@ </para> <para> Siehe auch <function>sort</function>, - <function>natsort</function>, - <function>strnatcmp</function> und + <function>natsort</function>, <function>strnatcmp</function> und <function>strnatcasecmp</function>. </para> </refsect1> @@ -2624,31 +2692,32 @@ </funcprototype> </funcsynopsis> <para> - Diese Funktion gibt das nächste Element des Arrays zurück, auf das - der interne Zeiger des Arrays gerade zeigt. Sind keine Elemente mehr - vorhanden, wird &false; zurückgegeben. + Diese Funktion gibt das nächste Element des Arrays zurück, auf + das der interne Zeiger des Arrays gerade zeigt. Sind keine + Elemente mehr vorhanden, wird &false; zurückgegeben. </para> <para> - <function>next</function> verhält sich ähnlich wie - <function>current</function>, mit einem Unterschied. Der interne - Zeiger wird um ein Element vorgerückt, bevor das Element zurückgegeben - wird, d.h. es wird das nächste Element zurückgegeben, und der interne - Zeiger um eins erhöht. Zeigt der interne Zeiger hinter das Ende der - Elementliste, wird &false; zurückgegeben. + <function>next</function> verhält sich ähnlich wie + <function>current</function>, mit einem Unterschied. Der interne + Zeiger wird um ein Element vorgerückt, bevor das Element + zurückgegeben wird, d.h. es wird das nächste Element + zurückgegeben, und der interne Zeiger um eins erhöht. Zeigt der + interne Zeiger hinter das Ende der Elementliste, wird &false; + zurückgegeben. <warning> <para> - Enthält das Array leere Elemente oder Elemente mit dem Schlüssel 0, - wird für diese Elemente ebenfalls &false; - zurückgegeben. Um ein Array, das leere Elemente oder Elemente mit - dem Schlüssel 0 enthalten könnte richtig durchzugehen, + Enthält das Array leere Elemente oder Elemente mit dem + Schlüssel 0, wird für diese Elemente ebenfalls &false; + zurückgegeben. Um ein Array, das leere Elemente oder Elemente + mit dem Schlüssel 0 enthalten könnte richtig durchzugehen, verwenden Sie die Funktion <function>each</function>. </para> </warning> </para> <para> - Siehe auch: - <function>current</function>, <function>end</function>, - <function>prev</function>, und <function>reset</function>. + Siehe auch: <function>current</function>, + <function>end</function>, <function>prev</function> und + <function>reset</function>. </para> </refsect1> </refentry> @@ -2667,7 +2736,8 @@ </funcprototype> </funcsynopsis> <simpara> - Dies ist nur ein Alias für die Funktion <function>current</function>. + Dies ist nur ein Alias für die Funktion + <function>current</function>. </simpara> <para> Siehe auch: @@ -2680,7 +2750,9 @@ <refentry id="function.prev"> <refnamediv> <refname>prev</refname> - <refpurpose>Verkleinert den internen Zeiger eines Arrays</refpurpose> + <refpurpose> + Verkleinert den internen Zeiger eines Arrays + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -2691,26 +2763,27 @@ </funcprototype> </funcsynopsis> <para> - Liefert das Element vor der Position des Arrays, auf die der interne - Zeiger gerade zeigt. Sind keine Elemente mehr vorhanden, wird - &false; zurückgegeben. + Liefert das Element vor der Position des Arrays, auf die der + interne Zeiger gerade zeigt. Sind keine Elemente mehr vorhanden, + wird &false; zurückgegeben. <warning> <para> - Enthält das Array leere Elemente, wird für diese ebenfalls - &false; zurückgegeben. Um ein Array mit leeren - Elementen richtig durchzugehen, verwenden Sie die Funktion + Enthält das Array leere Elemente, wird für diese ebenfalls + &false; zurückgegeben. Um ein Array mit leeren Elementen + richtig durchzugehen, verwenden Sie die Funktion <function>each</function>. </para> </warning> </para> - <para> - <function>prev</function> verhält sich wie <function>next</function>, - nur dass hier der interne Zeiger um eine Position zurück, und nicht - nach vorne gerückt wird. + <para> + <function>prev</function> verhält sich wie + <function>next</function>, nur dass hier der interne Zeiger um + eine Position zurück, und nicht nach vorne gerückt wird. </para> <para> - Siehe auch: <function>current</function>, <function>end</function>, - <function>next</function>, und <function>reset</function>. + Siehe auch: <function>current</function>, + <function>end</function>, <function>next</function> und + <function>reset</function>. </para> </refsect1> </refentry> @@ -2732,35 +2805,36 @@ </funcprototype> </funcsynopsis> <para> - <function>range</function> gibt ein Array mit Elementen im - Bereich von <parameter>low</parameter> bis - <parameter>high</parameter> zurück. Wenn low > high, wird die + <function>range</function> gibt ein Array mit Elementen im + Bereich von <parameter>low</parameter> bis + <parameter>high</parameter> zurück. Wenn low > high, wird die Sequenz von high nach low sein. <example> <title><function>range</function> Beispiele</title> <programlisting role="php"> -foreach(range(0,9) as $number) { - echo $number; +foreach (range(0,9) as $number) { + echo $number; } -foreach(range('a','z') as $letter) { - echo $letter; +foreach (range('a','z') as $letter) { + echo $letter; } -foreach(range('z','a') as $letter) { - echo $letter; +foreach (range('z','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. - </para> - </note> + <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. + </para> + </note> <para> - Siehe <function>shuffle</function> für ein weiteres Anwendungsbeispiel. + Siehe <function>shuffle</function> für ein weiteres + Anwendungsbeispiel. </para> </refsect1> </refentry> @@ -2790,8 +2864,8 @@ </para> <para> Siehe auch: <function>current</function>, - <function>each</function>, <function>next</function>, - und <function>prev</function>. + <function>each</function>, <function>next</function> und + <function>prev</function>. </para> </refsect1> </refentry> @@ -2799,7 +2873,9 @@ <refentry id="function.rsort"> <refnamediv> <refname>rsort</refname> - <refpurpose>Sortiert ein Array in umgekehrter Reihenfolge</refpurpose> + <refpurpose> + Sortiert ein Array in umgekehrter Reihenfolge + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -2813,7 +2889,7 @@ </funcprototype> </funcsynopsis> <para> - Diese Funktion sortiert ein Array in umgekehrter Reihenfolge (vom + Diese Funktion sortiert ein Array in umgekehrter Reihenfolge (vom höchsten zum niedrigsten Wert). <example> <title><function>rsort</function></title> @@ -2841,17 +2917,18 @@ </informalexample> </para> <para> - Die Früchte wurden in umgekehrter alphabetischer Reihenfolge sortiert. + Die Früchte wurden in umgekehrter alphabetischer Reihenfolge + sortiert. </para> <para> - Sie können das Verhalten der Sortierung mittels dem optionalen - Parameter <parameter>sort_flags</parameter> beeinflussen, für Details - siehe <function>sort</function>. + Sie können das Verhalten der Sortierung mittels dem optionalen + Parameter <parameter>sort_flags</parameter> beeinflussen, für + Details siehe <function>sort</function>. </para> <para> Siehe auch: <function>arsort</function>, <function>asort</function>, <function>ksort</function>, - <function>sort</function>, und <function>usort</function>. + <function>sort</function> und <function>usort</function>. </para> </refsect1> </refentry> @@ -2870,8 +2947,8 @@ </funcprototype> </funcsynopsis> <para> - Diese Funktion mischt die Reihenfolge der Elemente eines Arrays - zufällig (shuffle). Benutzen Sie <function>srand</function>, um + Diese Funktion mischt die Reihenfolge der Elemente eines Arrays + zufällig (shuffle). Benutzen Sie <function>srand</function>, um den Startwert für den Zufallsgenerator festzulegen. <example> <title><function>shuffle</function></title> @@ -2886,9 +2963,10 @@ </example> </para> <para> - Siehe auch: <function>arsort</function>, <function>asort</function>, - <function>ksort</function>, <function>rsort</function>, - <function>sort</function> und <function>usort</function>. + Siehe auch: <function>arsort</function>, + <function>asort</function>, <function>ksort</function>, + <function>rsort</function>, <function>sort</function> und + <function>usort</function>. </para> </refsect1> </refentry> @@ -2896,7 +2974,9 @@ <refentry id="function.sizeof"> <refnamediv> <refname>sizeof</refname> - <refpurpose>Liefert die Anzahl Elemente einer Variable</refpurpose> + <refpurpose> + Liefert die Anzahl Elemente einer Variable + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -2907,7 +2987,8 @@ </funcprototype> </funcsynopsis> <para> - Die Funktion <function>sizeof</function> ist ein Alias für <function>count</function>. + Die Funktion <function>sizeof</function> ist ein Alias für + <function>count</function>. </para> <para> Siehe auch <function>count</function>. @@ -2926,15 +3007,17 @@ <funcprototype> <funcdef>void <function>sort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> - <paramdef>int <parameter><optional>sort_flags</optional></parameter></paramdef> + <paramdef>int + <parameter><optional>sort_flags</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> - Diese Funktion sortiert ein Array. Die Elemente werden aufsteigend vom - niedrigsten zum höchsten Wert sortiert. + Diese Funktion sortiert ein Array. Die Elemente werden + aufsteigend vom niedrigsten zum höchsten Wert sortiert. <example> <title><function>sort</function></title> - <programlisting role="php"> + <programlisting role="php"> &lt;?php $fruits = array ("Zitrone", "Orange", "Banane", "Apfel"); @@ -2966,7 +3049,7 @@ </para> <para> Der optionale zweite Parameter <parameter>sort_flags</parameter> - kann benutzt werden, um das Sortierverhalten mit den folgenden + kann benutzt werden, um das Sortierverhalten mit den folgenden Flags zu beeinflussen. </para> <para> @@ -2988,7 +3071,8 @@ <function>asort</function>, <function>ksort</function>, <function>natsort</function>, <function>natcasesort</function>, <function>rsort</function>, <function>usort</function>, - <function>array_multisort</function>, und <function>uksort</function>. + <function>array_multisort</function> und + <function>uksort</function>. </para> <note> <para> @@ -3002,8 +3086,8 @@ <refnamediv> <refname>uasort</refname> <refpurpose> - Sortiert ein Array mittels einer benutzerdefinierten Vergleichsfunktion - und behält Indexassoziationen bei. + Sortiert ein Array mittels einer benutzerdefinierten + Vergleichsfunktion und behält Indexassoziationen bei. </refpurpose> </refnamediv> <refsect1> @@ -3012,27 +3096,29 @@ <funcprototype> <funcdef>void <function>uasort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> - <paramdef>function <parameter>cmp_function</parameter></paramdef> + <paramdef>function + <parameter>cmp_function</parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> - Diese Funktion sortiert ein Array so, dass die Beziehung der - Indices zu den Arrayelementen beibehalten bleibt. Dies wird - hauptsächlich bei assoziativen Arrays angewandt, wenn die aktuelle - Reihenfolge der Arrayelemente signifikant ist. Die + Diese Funktion sortiert ein Array so, dass die Beziehung der + Indices zu den Arrayelementen beibehalten bleibt. Dies wird + hauptsächlich bei assoziativen Arrays angewandt, wenn die + aktuelle Reihenfolge der Arrayelemente signifikant ist. Die Vergleichsfunktion wird vom Benutzer definiert. </para> <note> <para> - Siehe <function>usort</function> und <function>uksort</function> - für Beispiele von benutzerdefinierten Vergleichsfunktionen + Siehe <function>usort</function> und <function>uksort</function> + für Beispiele von benutzerdefinierten Vergleichsfunktionen </para> </note> <para> - Siehe auch: <function>usort</function>, <function>uksort</function>, - <function>sort</function>, <function>asort</function>, - <function>arsort</function>, <function>ksort</function> - und <function>rsort</function>. + Siehe auch: <function>usort</function>, + <function>uksort</function>, <function>sort</function>, + <function>asort</function>, <function>arsort</function>, + <function>ksort</function> und <function>rsort</function>. </para> </refsect1> </refentry> @@ -3041,8 +3127,8 @@ <refnamediv> <refname>uksort</refname> <refpurpose> - Sortiert ein Array nach Schlüsseln mittels einer benutzerdefinierten - Vergleichsfunktion. + Sortiert ein Array nach Schlüsseln mittels einer + benutzerdefinierten Vergleichsfunktion. </refpurpose> </refnamediv> <refsect1> @@ -3055,9 +3141,9 @@ </funcprototype> </funcsynopsis> <para> - Diese Funktion sortiert die Schlüssel eines Arrays mittels einer - benutzerdefinierten Vergleichsfunktion. Soll das Array nach nicht - trivialen Kriterien sortiert werden, sollten Sie diese Funktion + Diese Funktion sortiert die Schlüssel eines Arrays mittels einer + benutzerdefinierten Vergleichsfunktion. Soll das Array nach nicht + trivialen Kriterien sortiert werden, sollten Sie diese Funktion verwenden. </para> <para> @@ -3093,10 +3179,11 @@ </informalexample> </para> <para> - Siehe auch: <function>usort</function>, <function>uasort</function>, - <function>sort</function>, <function>asort</function>, - <function>arsort</function>, <function>ksort</function>, - <function>natsort</function> und <function>rsort</function>. + Siehe auch: <function>usort</function>, + <function>uasort</function>, <function>sort</function>, + <function>asort</function>, <function>arsort</function>, + <function>ksort</function>, <function>natsort</function> und + <function>rsort</function>. </para> </refsect1> </refentry> @@ -3105,7 +3192,7 @@ <refnamediv> <refname>usort</refname> <refpurpose> - Sortiert ein Array nach Werten mittels einer benutzerdefinierten + Sortiert ein Array nach Werten mittels einer benutzerdefinierten Vergleichsfunktion. </refpurpose> </refnamediv> @@ -3119,17 +3206,17 @@ </funcprototype> </funcsynopsis> <para> - Diese Funktion sortiert ein Array nach seinen Werten mittels einer - benutzerdefinierten Vergleichsfunktion. Soll das Array nach nicht - trivialen Kriterien sortiert werden, sollten Sie diese Funktion - verwenden. + Diese Funktion sortiert ein Array nach seinen Werten mittels + einer benutzerdefinierten Vergleichsfunktion. Soll das Array nach + nicht trivialen Kriterien sortiert werden, sollten Sie diese + Funktion verwenden. </para> <para> - 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. + 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. </para> <para> <example> @@ -3166,14 +3253,15 @@ </para> <note> <para> - Offensichtlich würde <function>rsort</function> für diesen einfachen - Fall besser passen. + Offensichtlich würde <function>rsort</function> für diesen + einfachen Fall besser passen. </para> </note> <para> <example> <title> - <function>usort</function> Beispiel mit einem mehrdimensionalen Array + <function>usort</function> Beispiel mit einem mehrdimensionalen + Array </title> <programlisting role="php"> function cmp ($a, $b) { @@ -3193,7 +3281,7 @@ </example> </para> <para> - Wird ein mehrdimensionales Array sortiert, enthalten $a und $b + Wird ein mehrdimensionales Array sortiert, enthalten $a und $b Referenzen zu dem ersten Index des Arrays. </para> <para> @@ -3211,17 +3299,19 @@ <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. + 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> <para> - Siehe auch: <function>uasort</function>, <function>uksort</function>, - <function>sort</function>, <function>asort</function>, + Siehe auch: <function>uasort</function>, + <function>uksort</function>, <function>sort</function>, + <function>asort</function>, <function>arsort</function>,<function>ksort</function>, - <function>natsort</function>, und <function>rsort</function>. + <function>natsort</function> und <function>rsort</function>. </para> </refsect1> </refentry>