cvs: phpdoc-pl /reference/array/functions uksort.xml
| From: | Leszek Krupinski | Date: | Wed, 23 Feb 2005 01:08:18 +0000 |
| Subject: | cvs: phpdoc-pl /reference/array/functions uksort.xml | ||
| Groups: | php.doc.pl | ||
| Request: | Send a blank email to doc-pl+get-430@lists.php.net to get a copy of this message | ||
leszek Tue Feb 22 20:08:18 2005 EDT
Modified files:
/phpdoc-pl/reference/array/functions uksort.xml
Log:
[leszek] - updated to 1.15
http://cvs.php.net/diff.php/phpdoc-pl/reference/array/functions/uksort.xml?r1=1.5&r2=1.6&ty=u
Index: phpdoc-pl/reference/array/functions/uksort.xml
diff -u phpdoc-pl/reference/array/functions/uksort.xml:1.5
phpdoc-pl/reference/array/functions/uksort.xml:1.6
--- phpdoc-pl/reference/array/functions/uksort.xml:1.5 Thu Oct 31 21:04:02 2002
+++ phpdoc-pl/reference/array/functions/uksort.xml Tue Feb 22 20:08:18 2005
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.5 Maintainer: leszek Status: ready -->
-<!-- $Revision: 1.5 $ -->
+<!-- EN-Revision: 1.15 Maintainer: leszek Status: ready -->
+<!-- $Revision: 1.6 $ -->
<refentry id="function.uksort">
<refnamediv>
<refname>uksort</refname>
@@ -12,46 +12,58 @@
<refsect1>
<title>Opis</title>
<methodsynopsis>
- <type>void</type><methodname>uksort</methodname>
-
<methodparam><type>array</type><parameter>tablica</parameter></methodparam>
-
<methodparam><type>callback</type><parameter>funkcja_por</parameter></methodparam>
+ <type>bool</type><methodname>uksort</methodname>
+ <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 kluczy korzystaj±c z podanej przez
+ <function>uksort</function> sortuje tablicê wed³ug kluczy korzystaj±c z podanej
przez
u¿ytkownika funkcji porównuj±cej. Je¶li chcesz posortowaæ tablicê wed³ug
skomplikowanych kryteriów, to powiniene¶ u¿yæ tej funkcji.
</para>
+ <para>
+ Funkcja <parameter>funkcja_porównuj±ca</parameter> powinna przyjmowaæ dwa
+ parametry, którymi bêd± pary kluczy tablicy podanej jako pierwszy
+ parametr funkcji <function>uksort</function>. Funkcja porównuj±ca musi
+ zwracaæ liczbê ca³kowit±, mniejsz±, równ± lub wiêksz± od zera je¶li
+ pierwszy parametr jest odpowiednio mniejszy, równy lub wiêkszy ni¿ drugi.
+ </para>
+ <para>
+ &return.success;
+ </para>
<example>
<title>Przyk³ad u¿ycia <function>uksort</function></title>
<programlisting role="php">
<![CDATA[
-function cmp ($a, $b) {
- if ($a == $b) return 0;
+<?php
+function cmp($a, $b)
+{
+ if ($a == $b) {
+ return 0;
+ }
return ($a > $b) ? -1 : 1;
}
-$a = array (4 => "cztery", 3 => "trzy", 20 =>
"dwadzie¶cia", 10 => "dziesiêæ");
+$a = array(4 => "cztery", 3 => "trzy", 20 => "dwadzie¶cia",
10 => "dziesiêæ");
-uksort ($a, "cmp");
+uksort($a, "cmp");
-while (list ($key, $value) = each ($a)) {
+while (list($key, $value) = each($a)) {
echo "$key: $value\n";
}
+?>
]]>
- </programlisting>
- </example>
- <para>
- Ten przyk³ad wy¶wietli:
- </para>
- <para>
- <screen>
+ </programlisting>
+ &example.output;
+ <screen>
<![CDATA[
20: dwadzie¶cia
10: dziesiêæ
4: cztery
3: trzy
]]>
- </screen>
+ </screen>
+ </example>
</para>
<para>
Patrz tak¿e: <function>usort</function>, <function>uasort</function>,