cvs: phpdoc-de /reference/array/functions uasort.xml uksort.xml usort.xml
| From: | Hartmut Holzgraefe | Date: | Wed, 19 Mar 2008 18:55:23 +0000 |
| Subject: | cvs: phpdoc-de /reference/array/functions uasort.xml uksort.xml usort.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-2574@lists.php.net to get a copy of this message | ||
hholzgra Wed Mar 19 18:55:23 2008 UTC
Modified files:
/phpdoc-de/reference/array/functions uasort.xml uksort.xml
usort.xml
Log:
translation updates
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/array/functions/uasort.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-de/reference/array/functions/uasort.xml diff -u phpdoc-de/reference/array/functions/uasort.xml:1.11 phpdoc-de/reference/array/functions/uasort.xml:1.12 --- phpdoc-de/reference/array/functions/uasort.xml:1.11 Wed Mar 19 18:05:43 2008 +++ phpdoc-de/reference/array/functions/uasort.xml Wed Mar 19 18:55:23 2008 @@ -1,44 +1,73 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.10 Maintainer: simp Status: ready --> -<!-- CREDITS: tom --> - <refentry xml:id="function.uasort" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>uasort</refname> - <refpurpose>Sortiert ein Array mittels einer benutzerdefinierten - Vergleichsfunktion und behält Indexassoziationen bei.</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description - <methodsynopsis> - <type>bool</type><methodname>uasort</methodname> - <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam> - <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> - </methodsynopsis> - <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 - Vergleichsfunktion wird vom Benutzer definiert. - </para> - <para> - &return.success; - </para> - <note> - <para> - 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>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.11 Maintainer: hholzgra Status: ready --> +<!-- CREDITS: tom, simp --> +<refentry xml:id="function.uasort" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>uasort</refname> + <refpurpose>Sortiert ein Array mittels einer benutzerdefinierten + Vergleichsfunktion und behält Indexassoziationen bei.</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>uasort</methodname> + <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam> + <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> + </methodsynopsis> + <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 + Vergleichsfunktion wird vom Benutzer definiert. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>array</parameter></term> + <listitem> + <para> + Das zu sortierende Array. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>cmp_function</parameter></term> + <listitem> + <para> + Siehe <function>usort</function> und <function>uksort</function> für + Beispiele benutzerdefinierter Vergleichsfunktionen. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>usort</function></member> + <member><function>uksort</function></member> + <member><function>asort</function></member> + <member><function>arsort</function></member> + <member><function>ksort</function></member> + <member><function>rsort</function></member> + <member><function>sort</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/array/functions/uksort.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-de/reference/array/functions/uksort.xml diff -u phpdoc-de/reference/array/functions/uksort.xml:1.11 phpdoc-de/reference/array/functions/uksort.xml:1.12 --- phpdoc-de/reference/array/functions/uksort.xml:1.11 Wed Mar 19 18:05:43 2008 +++ phpdoc-de/reference/array/functions/uksort.xml Wed Mar 19 18:55:23 2008 @@ -1,77 +1,118 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.20 Maintainer: simp Status: ready --> -<!-- CREDITS: tom --> - <refentry xml:id="function.uksort" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>uksort</refname> - <refpurpose>Sortiert ein Array nach Schlüsseln mittels einer - benutzerdefinierten Vergleichsfunktion.</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description - <methodsynopsis> - <type>bool</type><methodname>uksort</methodname> - <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam> - <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> - </methodsynopsis> - <para> - <function>uksort</function> 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> - Die Funktion <parameter>cmp_function</parameter> sollte zwei Parameter - annehmen, die mit Paaren von Schlüsseln aus <parameter>array</parameter> - gefüllt werden. Die vergleichsfunktion muss einen Integer kleiner als, - genau gleich oder größer als Null zurückgeben, wenn das erste Argument - entsprechend als kleiner, gleich oder größer als das Zweite betrachtet - wird. - </para> - <para> - &return.success; - </para> - <para> - <example> - <title><function>uksort</function></title> - <programlisting role="php"> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.22 Maintainer: hholzgra Status: ready --> +<!-- CREDITS: tom, simp --> +<refentry xml:id="function.uksort" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>uksort</refname> + <refpurpose>Sortiert ein Array nach Schlüsseln mittels einer + benutzerdefinierten Vergleichsfunktion.</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>uksort</methodname> + <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam> + <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> + </methodsynopsis> + <para> + <function>uksort</function> 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> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>array</parameter></term> + <listitem> + <para> + Das zu sortierende Array. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>cmp_function</parameter></term> + <listitem> + <para> + Die aufzurufende Vergleichsfunktion. + </para> + <para> + Die Funktion <parameter>cmp_function</parameter> sollte zwei Parameter + annehmen, die mit Paaren von Schlüsseln aus <parameter>array</parameter> + gefüllt werden. Die vergleichsfunktion muss einen Integer kleiner als, + genau gleich oder größer als Null zurückgeben, wenn das erste Argument + entsprechend als kleiner, gleich oder größer als das Zweite betrachtet + wird. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>uksort</function> Beispiel</title> + <programlisting role="php"> <![CDATA[ +<?php function cmp($a, $b) { - $a = ereg_replace('^(ein|eine|die) ', '', $a); - $b = ereg_replace('^(ein|eine|die) ', '', $b); - return strcasecmp($a, $b); + $a = ereg_replace('^(a|an|the) ', '', $a); + $b = ereg_replace('^(a|an|the) ', '', $b); + return strcasecmp($a, $b); } -$a = array("John" => 1, "die Erde" => 2, "ein Apfel" => 3, "eine Banane" => 4); +$a = array("John" => 1, "the Earth" => 2, "an apple" => 3, "a banana" => 4); uksort($a, "cmp"); foreach ($a as $key => $value) { echo "$key: $value\n"; } +?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ -ein Apfel: 3 -eine Banane: 4 -die Erde: 2 +an apple: 3 +a banana: 4 +the Earth: 2 John: 1 ]]> - </screen> - </example> - </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>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>usort</function></member> + <member><function>uasort</function></member> + <member><function>sort</function></member> + <member><function>asort</function></member> + <member><function>arsort</function></member> + <member><function>ksort</function></member> + <member><function>natsort</function></member> + <member><function>rsort</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/array/functions/usort.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-de/reference/array/functions/usort.xml diff -u phpdoc-de/reference/array/functions/usort.xml:1.14 phpdoc-de/reference/array/functions/usort.xml:1.15 --- phpdoc-de/reference/array/functions/usort.xml:1.14 Wed Mar 19 18:05:43 2008 +++ phpdoc-de/reference/array/functions/usort.xml Wed Mar 19 18:55:23 2008 @@ -1,51 +1,98 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.25 Maintainer: simp Status: ready --> -<!-- CREDITS: tom --> - <refentry xml:id="function.usort" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>usort</refname> - <refpurpose>Sortiert ein Array nach Werten mittels einer benutzerdefinierten - Vergleichsfunktion.</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description - <methodsynopsis> - <type>bool</type><methodname>usort</methodname> - <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam> - <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> - </methodsynopsis> - <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. - </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. - </para> - <para> - <note> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.27 Maintainer: hholzgra Status: ready --> +<!-- CREDITS: tom, simp --> +<refentry xml:id="function.usort" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>usort</refname> + <refpurpose>Sortiert ein Array nach Werten mittels einer benutzerdefinierten + Vergleichsfunktion.</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>usort</methodname> + <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam> + <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> + </methodsynopsis> + <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. + </para> + <note> + <para> + Wenn zwei Elemente als gleich verglichen werden ist ihre Reihenfolge + im sortierten Array undefiniert. + </para> + </note> + ¬e.no-key-association; + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>array</parameter></term> + <listitem> <para> - Sind zwei Elemente gleich, ist deren Reihenfolge nicht definiert. Bis zu - PHP 4.0.6 würde die benutzerdefinierte Funktion die originäre Reihenfolge - beibehalten, doch seit der Einführung des neuen Sortieralgorhythmus mit - 4.1.0 ist dies nicht mehr der Fall, da es keine effiziente Lösung dafür - gibt. + Das zu sortierende Array. </para> - </note> - </para> - ¬e.no-key-association; - <para> - &return.success; - </para> - <para> - <example> - <title><function>usort</function></title> - <programlisting role="php"> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>cmp_function</parameter></term> + <listitem> + <para> + Die Vergleichsfunktion muss einen Integerwert kleiner als, + gleich oder größer als 0 zurückgeben je nachdem ob das + erste übergebene Argument kleiner als, gleich oder + größer als das zweite ist. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.1.0</entry> + <entry> + Es wurde ein neuer Sotieralgorithmus eingeführt, die Reihenfolge + von Elementen die von <parameter>cmp_function</parameter> + als gleich bewertet wurden bleibt nun nicht mehr erhalten. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>usort</function> Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php function cmp($a, $b) @@ -56,20 +103,18 @@ return ($a < $b) ? -1 : 1; } - - $a = array(3, 2, 5, 6, 1); -usort ($a, "cmp"); +usort($a, "cmp"); foreach ($a as $key => $value) { echo "$key: $value\n"; } ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ 0: 1 1: 2 @@ -77,60 +122,61 @@ 3: 5 4: 6 ]]> - </screen> - </example> - </para> - <note> - <para> - Offensichtlich würde <function>sort</function> für diesen - einfachen Fall besser passen. - </para> - </note> - <para> - <example> - <title> - <function>usort</function> mit einem mehrdimensionalen Array - </title> - <programlisting role="php"> + </screen> + </example> + </para> + <note> + <para> + Für dieses einfache Beispiel währe die + <function>sort</function> Funktion offensichtlich + die bessere Wahl. + </para> + </note> + <para> + <example> + <title> + <function>usort</function> Beispiel für multidimensionale Arrays + </title> + <programlisting role="php"> <![CDATA[ <?php -function cmp($a, $b) { - return strcmp($a["fruit"], $b["fruit"]); +function cmp($a, $b) +{ + return strcmp($a["frucht"], $b["frucht"]); } -$fruits[0]["fruit"] = "Zitrone"; -$fruits[1]["fruit"] = "Apfel"; -$fruits[2]["fruit"] = "Traube"; +$fruechte[0]["frucht"] = "Zitronen"; +$fruechte[1]["frucht"] = "Aepfel"; +$fruechte[2]["frucht"] = "Orangen"; -usort($fruits, "cmp"); +usort($fruechte, "cmp"); -while (list ($key, $value) = each($fruits)) { - echo "\$fruits[$key]: " . $value["fruit"] . "\n"; +while (list($key, $value) = each($fruits)) { + echo "\$fruechte[$key]: " . $value["frucht"] . "\n"; } ?> ]]> - </programlisting> - <para> - Wird ein mehrdimensionales Array sortiert, enthalten <varname>$a</varname> - und <varname>$b</varname> Referenzen zu dem ersten Index des Arrays. - </para> - &example.outputs; - <screen> + </programlisting> + <para> + When sorting a multi-dimensional array, <varname>$a</varname> and + <varname>$b</varname> contain references to the first index of the array. + </para> + &example.outputs; + <screen> <![CDATA[ -$fruits[0]: Apfel -$fruits[1]: Traube -$fruits[2]: Zitrone +$fruechte[0]: Aepfel +$fruechte[1]: Orangen +$fruechte[2]: Zitronen ]]> - </screen> - </example> - </para> - - <para> - <example> - <title> - <function>usort</function> mit Verwendung einer Member Funktion eines Objektes - </title> - <programlisting role="php"> + </screen> + </example> + </para> + <para> + <example> + <title> + <function>usort</function> Beispiel das die Methode eines Objekts benutzt + </title> + <programlisting role="php"> <![CDATA[ <?php class TestObj { @@ -141,8 +187,8 @@ $this->name = $name; } - /* Dies ist die statische Vergleichsfunktion: */ - function cmp_obj($a, $b) + /* Dies ist die Vergleichsfunktion */ + static function cmp_obj($a, $b) { $al = strtolower($a->name); $bl = strtolower($b->name); @@ -157,34 +203,41 @@ $a[] = new TestObj("b"); $a[] = new TestObj("d"); -usort($a, array ("TestObj", "cmp_obj")); +usort($a, array("TestObj", "cmp_obj")); foreach ($a as $item) { - echo $item->name."\n"; + echo $item->name . "\n"; } ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ b c d ]]> - </screen> - </example> - </para> - - <para> - 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>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>uasort</function></member> + <member><function>uksort</function></member> + <member><function>sort</function></member> + <member><function>asort</function></member> + <member><function>arsort</function></member> + <member><function>ksort</function></member> + <member><function>natsort</function></member> + <member><function>rsort</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables:
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/array/functions/uasort.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-de/reference/array/functions/uasort.xml diff -u phpdoc-de/reference/array/functions/uasort.xml:1.11 phpdoc-de/reference/array/functions/uasort.xml:1.12 --- phpdoc-de/reference/array/functions/uasort.xml:1.11 Wed Mar 19 18:05:43 2008 +++ phpdoc-de/reference/array/functions/uasort.xml Wed Mar 19 18:55:23 2008 @@ -1,44 +1,73 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.10 Maintainer: simp Status: ready --> -<!-- CREDITS: tom --> - <refentry xml:id="function.uasort" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>uasort</refname> - <refpurpose>Sortiert ein Array mittels einer benutzerdefinierten - Vergleichsfunktion und behält Indexassoziationen bei.</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description - <methodsynopsis> - <type>bool</type><methodname>uasort</methodname> - <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam> - <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> - </methodsynopsis> - <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 - Vergleichsfunktion wird vom Benutzer definiert. - </para> - <para> - &return.success; - </para> - <note> - <para> - 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>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.11 Maintainer: hholzgra Status: ready --> +<!-- CREDITS: tom, simp --> +<refentry xml:id="function.uasort" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>uasort</refname> + <refpurpose>Sortiert ein Array mittels einer benutzerdefinierten + Vergleichsfunktion und behält Indexassoziationen bei.</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>uasort</methodname> + <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam> + <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> + </methodsynopsis> + <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 + Vergleichsfunktion wird vom Benutzer definiert. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>array</parameter></term> + <listitem> + <para> + Das zu sortierende Array. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>cmp_function</parameter></term> + <listitem> + <para> + Siehe <function>usort</function> und <function>uksort</function> für + Beispiele benutzerdefinierter Vergleichsfunktionen. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>usort</function></member> + <member><function>uksort</function></member> + <member><function>asort</function></member> + <member><function>arsort</function></member> + <member><function>ksort</function></member> + <member><function>rsort</function></member> + <member><function>sort</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/array/functions/uksort.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-de/reference/array/functions/uksort.xml diff -u phpdoc-de/reference/array/functions/uksort.xml:1.11 phpdoc-de/reference/array/functions/uksort.xml:1.12 --- phpdoc-de/reference/array/functions/uksort.xml:1.11 Wed Mar 19 18:05:43 2008 +++ phpdoc-de/reference/array/functions/uksort.xml Wed Mar 19 18:55:23 2008 @@ -1,77 +1,118 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.20 Maintainer: simp Status: ready --> -<!-- CREDITS: tom --> - <refentry xml:id="function.uksort" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>uksort</refname> - <refpurpose>Sortiert ein Array nach Schlüsseln mittels einer - benutzerdefinierten Vergleichsfunktion.</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description - <methodsynopsis> - <type>bool</type><methodname>uksort</methodname> - <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam> - <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> - </methodsynopsis> - <para> - <function>uksort</function> 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> - Die Funktion <parameter>cmp_function</parameter> sollte zwei Parameter - annehmen, die mit Paaren von Schlüsseln aus <parameter>array</parameter> - gefüllt werden. Die vergleichsfunktion muss einen Integer kleiner als, - genau gleich oder größer als Null zurückgeben, wenn das erste Argument - entsprechend als kleiner, gleich oder größer als das Zweite betrachtet - wird. - </para> - <para> - &return.success; - </para> - <para> - <example> - <title><function>uksort</function></title> - <programlisting role="php"> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.22 Maintainer: hholzgra Status: ready --> +<!-- CREDITS: tom, simp --> +<refentry xml:id="function.uksort" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>uksort</refname> + <refpurpose>Sortiert ein Array nach Schlüsseln mittels einer + benutzerdefinierten Vergleichsfunktion.</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>uksort</methodname> + <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam> + <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> + </methodsynopsis> + <para> + <function>uksort</function> 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> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>array</parameter></term> + <listitem> + <para> + Das zu sortierende Array. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>cmp_function</parameter></term> + <listitem> + <para> + Die aufzurufende Vergleichsfunktion. + </para> + <para> + Die Funktion <parameter>cmp_function</parameter> sollte zwei Parameter + annehmen, die mit Paaren von Schlüsseln aus <parameter>array</parameter> + gefüllt werden. Die vergleichsfunktion muss einen Integer kleiner als, + genau gleich oder größer als Null zurückgeben, wenn das erste Argument + entsprechend als kleiner, gleich oder größer als das Zweite betrachtet + wird. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>uksort</function> Beispiel</title> + <programlisting role="php"> <![CDATA[ +<?php function cmp($a, $b) { - $a = ereg_replace('^(ein|eine|die) ', '', $a); - $b = ereg_replace('^(ein|eine|die) ', '', $b); - return strcasecmp($a, $b); + $a = ereg_replace('^(a|an|the) ', '', $a); + $b = ereg_replace('^(a|an|the) ', '', $b); + return strcasecmp($a, $b); } -$a = array("John" => 1, "die Erde" => 2, "ein Apfel" => 3, "eine Banane" => 4); +$a = array("John" => 1, "the Earth" => 2, "an apple" => 3, "a banana" => 4); uksort($a, "cmp"); foreach ($a as $key => $value) { echo "$key: $value\n"; } +?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ -ein Apfel: 3 -eine Banane: 4 -die Erde: 2 +an apple: 3 +a banana: 4 +the Earth: 2 John: 1 ]]> - </screen> - </example> - </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>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>usort</function></member> + <member><function>uasort</function></member> + <member><function>sort</function></member> + <member><function>asort</function></member> + <member><function>arsort</function></member> + <member><function>ksort</function></member> + <member><function>natsort</function></member> + <member><function>rsort</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/array/functions/usort.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-de/reference/array/functions/usort.xml diff -u phpdoc-de/reference/array/functions/usort.xml:1.14 phpdoc-de/reference/array/functions/usort.xml:1.15 --- phpdoc-de/reference/array/functions/usort.xml:1.14 Wed Mar 19 18:05:43 2008 +++ phpdoc-de/reference/array/functions/usort.xml Wed Mar 19 18:55:23 2008 @@ -1,51 +1,98 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.25 Maintainer: simp Status: ready --> -<!-- CREDITS: tom --> - <refentry xml:id="function.usort" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>usort</refname> - <refpurpose>Sortiert ein Array nach Werten mittels einer benutzerdefinierten - Vergleichsfunktion.</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description - <methodsynopsis> - <type>bool</type><methodname>usort</methodname> - <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam> - <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> - </methodsynopsis> - <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. - </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. - </para> - <para> - <note> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.27 Maintainer: hholzgra Status: ready --> +<!-- CREDITS: tom, simp --> +<refentry xml:id="function.usort" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>usort</refname> + <refpurpose>Sortiert ein Array nach Werten mittels einer benutzerdefinierten + Vergleichsfunktion.</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>usort</methodname> + <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam> + <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> + </methodsynopsis> + <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. + </para> + <note> + <para> + Wenn zwei Elemente als gleich verglichen werden ist ihre Reihenfolge + im sortierten Array undefiniert. + </para> + </note> + ¬e.no-key-association; + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>array</parameter></term> + <listitem> <para> - Sind zwei Elemente gleich, ist deren Reihenfolge nicht definiert. Bis zu - PHP 4.0.6 würde die benutzerdefinierte Funktion die originäre Reihenfolge - beibehalten, doch seit der Einführung des neuen Sortieralgorhythmus mit - 4.1.0 ist dies nicht mehr der Fall, da es keine effiziente Lösung dafür - gibt. + Das zu sortierende Array. </para> - </note> - </para> - ¬e.no-key-association; - <para> - &return.success; - </para> - <para> - <example> - <title><function>usort</function></title> - <programlisting role="php"> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>cmp_function</parameter></term> + <listitem> + <para> + Die Vergleichsfunktion muss einen Integerwert kleiner als, + gleich oder größer als 0 zurückgeben je nachdem ob das + erste übergebene Argument kleiner als, gleich oder + größer als das zweite ist. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.1.0</entry> + <entry> + Es wurde ein neuer Sotieralgorithmus eingeführt, die Reihenfolge + von Elementen die von <parameter>cmp_function</parameter> + als gleich bewertet wurden bleibt nun nicht mehr erhalten. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>usort</function> Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php function cmp($a, $b) @@ -56,20 +103,18 @@ return ($a < $b) ? -1 : 1; } - - $a = array(3, 2, 5, 6, 1); -usort ($a, "cmp"); +usort($a, "cmp"); foreach ($a as $key => $value) { echo "$key: $value\n"; } ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ 0: 1 1: 2 @@ -77,60 +122,61 @@ 3: 5 4: 6 ]]> - </screen> - </example> - </para> - <note> - <para> - Offensichtlich würde <function>sort</function> für diesen - einfachen Fall besser passen. - </para> - </note> - <para> - <example> - <title> - <function>usort</function> mit einem mehrdimensionalen Array - </title> - <programlisting role="php"> + </screen> + </example> + </para> + <note> + <para> + Für dieses einfache Beispiel währe die + <function>sort</function> Funktion offensichtlich + die bessere Wahl. + </para> + </note> + <para> + <example> + <title> + <function>usort</function> Beispiel für multidimensionale Arrays + </title> + <programlisting role="php"> <![CDATA[ <?php -function cmp($a, $b) { - return strcmp($a["fruit"], $b["fruit"]); +function cmp($a, $b) +{ + return strcmp($a["frucht"], $b["frucht"]); } -$fruits[0]["fruit"] = "Zitrone"; -$fruits[1]["fruit"] = "Apfel"; -$fruits[2]["fruit"] = "Traube"; +$fruechte[0]["frucht"] = "Zitronen"; +$fruechte[1]["frucht"] = "Aepfel"; +$fruechte[2]["frucht"] = "Orangen"; -usort($fruits, "cmp"); +usort($fruechte, "cmp"); -while (list ($key, $value) = each($fruits)) { - echo "\$fruits[$key]: " . $value["fruit"] . "\n"; +while (list($key, $value) = each($fruits)) { + echo "\$fruechte[$key]: " . $value["frucht"] . "\n"; } ?> ]]> - </programlisting> - <para> - Wird ein mehrdimensionales Array sortiert, enthalten <varname>$a</varname> - und <varname>$b</varname> Referenzen zu dem ersten Index des Arrays. - </para> - &example.outputs; - <screen> + </programlisting> + <para> + When sorting a multi-dimensional array, <varname>$a</varname> and + <varname>$b</varname> contain references to the first index of the array. + </para> + &example.outputs; + <screen> <![CDATA[ -$fruits[0]: Apfel -$fruits[1]: Traube -$fruits[2]: Zitrone +$fruechte[0]: Aepfel +$fruechte[1]: Orangen +$fruechte[2]: Zitronen ]]> - </screen> - </example> - </para> - - <para> - <example> - <title> - <function>usort</function> mit Verwendung einer Member Funktion eines Objektes - </title> - <programlisting role="php"> + </screen> + </example> + </para> + <para> + <example> + <title> + <function>usort</function> Beispiel das die Methode eines Objekts benutzt + </title> + <programlisting role="php"> <![CDATA[ <?php class TestObj { @@ -141,8 +187,8 @@ $this->name = $name; } - /* Dies ist die statische Vergleichsfunktion: */ - function cmp_obj($a, $b) + /* Dies ist die Vergleichsfunktion */ + static function cmp_obj($a, $b) { $al = strtolower($a->name); $bl = strtolower($b->name); @@ -157,34 +203,41 @@ $a[] = new TestObj("b"); $a[] = new TestObj("d"); -usort($a, array ("TestObj", "cmp_obj")); +usort($a, array("TestObj", "cmp_obj")); foreach ($a as $item) { - echo $item->name."\n"; + echo $item->name . "\n"; } ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ b c d ]]> - </screen> - </example> - </para> - - <para> - 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>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>uasort</function></member> + <member><function>uksort</function></member> + <member><function>sort</function></member> + <member><function>asort</function></member> + <member><function>arsort</function></member> + <member><function>ksort</function></member> + <member><function>natsort</function></member> + <member><function>rsort</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: