cvs: phpdoc-pl /reference/array/functions usort.xml

From: Date: Wed, 23 Feb 2005 01:08:20 +0000
Subject: cvs: phpdoc-pl /reference/array/functions usort.xml
Groups: php.doc.pl 
Request: Send a blank email to doc-pl+get-431@lists.php.net to get a copy of this message
leszek Tue Feb 22 20:08:20 2005 EDT Modified files: /phpdoc-pl/reference/array/functions usort.xml Log: [leszek] - updated to 1.21 http://cvs.php.net/diff.php/phpdoc-pl/reference/array/functions/usort.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc-pl/reference/array/functions/usort.xml diff -u phpdoc-pl/reference/array/functions/usort.xml:1.6 phpdoc-pl/reference/array/functions/usort.xml:1.7 --- phpdoc-pl/reference/array/functions/usort.xml:1.6 Thu Oct 31 21:04:04 2002 +++ phpdoc-pl/reference/array/functions/usort.xml Tue Feb 22 20:08:20 2005 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.7 Maintainer: leszek Status: ready --> -<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.21 Maintainer: leszek Status: ready --> +<!-- $Revision: 1.7 $ --> <refentry id="function.usort"> <refnamediv> <refname>usort</refname> <refpurpose> - Sortuj tablicê wed³ug warto¶ci korzystaj±c ze zdefiniowanej przez + Sortuje tablicê wed³ug warto¶ci korzystaj±c ze zdefiniowanej przez u¿ytkownika funkcji porównuj±cej </refpurpose> </refnamediv> @@ -13,8 +13,8 @@ <title>Opis</title> <methodsynopsis> <type>void</type><methodname>usort</methodname> - <methodparam><type>array</type><parameter>tablica</parameter></methodparam> - <methodparam><type>callback</type><parameter>funkcja_por</parameter></methodparam> + <methodparam><type>array</type><parameter role="reference">tablica</parameter></methodparam> + <methodparam><type>callback</type><parameter>funkcja_porównuj±ca</parameter></methodparam> </methodsynopsis> <para> Funkcja ta posortuje tablicê wed³ug jej warto¶ci korzystaj±c z podanej @@ -25,6 +25,8 @@ Funkcja porównuj±ca musi zwracaæ liczbê ca³kowit± mniejsz±, równ± lub wiêksz± od zera je¶li pierwszy argument jest odpowiednio mniejszy, równy lub wiêkszy ni¿ drugi. + </para> + <para> <note> <para> Je¶li wynikiem porównania dwóch elementów tablicy jest równo¶æ, ich @@ -37,31 +39,34 @@ </note> </para> <para> + &return.success; + </para> + <para> <example> <title>Przyk³ad u¿ycia <function>usort</function></title> <programlisting role="php"> <![CDATA[ -function cmp ($a, $b) { - if ($a == $b) return 0; - return ($a > $b) ? -1 : 1; +<?php +function cmp($a, $b) +{ + if ($a == $b) { + return 0; + } + return ($a < $b) ? -1 : 1; } -$a = array (3, 2, 5, 6, 1); +$a = array(3, 2, 5, 6, 1); -usort ($a, "cmp"); +usort($a, "cmp"); -while (list ($key, $value) = each ($a)) { +while (list($key, $value) = each($a)) { echo "$key: $value\n"; } +?> ]]> </programlisting> - </example> - </para> - <para> - Powy¿szy przyk³ad wy¶wietli: - </para> - <para> - <screen> + &example.output; + <screen> <![CDATA[ 0: 6 1: 5 @@ -69,12 +74,13 @@ 3: 2 4: 1 ]]> - </screen> + </screen> + </example> </para> <note> <para> - Oczywi¶cie w prostszych przypadkach lepiej jest skorzystaæ z funkcji - <function>rsort</function>. + Oczywi¶cie w tym prostym przyk³adzie lepiej jest skorzystaæ z funkcji + <function>sort</function>. </para> </note> <para> @@ -85,7 +91,9 @@ </title> <programlisting role="php"> <![CDATA[ -function cmp ($a, $b) { +<?php +function cmp($a, $b) +{ return strcmp($a["owoc"], $b["owoc"]); } @@ -95,28 +103,24 @@ usort($owoce, "cmp"); -while (list ($key, $value) = each ($owoce)) { +while (list($key, $value) = each($owoce)) { echo "\$owoce[$key]: " . $value["owoc"] . "\n"; } ]]> </programlisting> - </example> - </para> - <para> - Sortuj±c tablicê wielowymiarow±, $a i $b zawieraj± referencjê do - pierwszego indeksu tablicy. - </para> - <para> - Ten przyk³ad wy¶wietli: - </para> - <para> - <screen> + <para> + Sortuj±c tablicê wielowymiarow±, $a i $b zawieraj± referencjê do + pierwszego indeksu tablicy. + </para> + &example.output; + <screen> <![CDATA[ $owoce[0]: cytryny $owoce[1]: jab³ka $owoce[2]: winogrona ]]> - </screen> + </screen> + </example> </para> <para> <example> @@ -126,6 +130,7 @@ </title> <programlisting role="php"> <![CDATA[ +<?php class TestObj { var $name; @@ -139,7 +144,9 @@ { $al = strtolower($a->name); $bl = strtolower($b->name); - if ($al == $bl) return 0; + if ($al == $bl) { + return 0; + } return ($al > $bl) ? +1 : -1; } } @@ -148,26 +155,22 @@ $a[] = new TestObj("b"); $a[] = new TestObj("d"); -uasort($a, array ("TestObj", "cmp_obj")); +uasort($a, array("TestObj", "cmp_obj")); foreach ($a as $item) { - print $item->name."\n"; + print $item->name . "\n"; } ]]> </programlisting> - </example> - </para> - <para> - Ten przyk³ad wy¶wietli: - </para> - <para> - <screen> + &example.output; + <screen> <![CDATA[ b c d ]]> - </screen> + </screen> + </example> </para> <para> Patrz tak¿e: <function>uasort</function>,

« previous php.doc.pl (#431) next »