cvs: phpdoc-pl /reference/array/functions usort.xml
| From: | Leszek Krupinski | 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>,