cvs: phpdoc-pl /reference/array/functions sort.xml
| From: | Leszek Krupinski | Date: | Wed, 23 Feb 2005 01:08:15 +0000 |
| Subject: | cvs: phpdoc-pl /reference/array/functions sort.xml | ||
| Groups: | php.doc.pl | ||
| Request: | Send a blank email to doc-pl+get-428@lists.php.net to get a copy of this message | ||
leszek Tue Feb 22 20:08:15 2005 EDT
Modified files:
/phpdoc-pl/reference/array/functions sort.xml
Log:
[leszek] - updated to 1.18
http://cvs.php.net/diff.php/phpdoc-pl/reference/array/functions/sort.xml?r1=1.4&r2=1.5&ty=u
Index: phpdoc-pl/reference/array/functions/sort.xml
diff -u phpdoc-pl/reference/array/functions/sort.xml:1.4
phpdoc-pl/reference/array/functions/sort.xml:1.5
--- phpdoc-pl/reference/array/functions/sort.xml:1.4 Fri May 17 09:50:48 2002
+++ phpdoc-pl/reference/array/functions/sort.xml Tue Feb 22 20:08:15 2005
@@ -1,50 +1,58 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.4 Maintainer: leszek Status: ready -->
-<!-- $Revision: 1.4 $ -->
+<!-- EN-Revision: 1.18 Maintainer: leszek Status: ready -->
+<!-- $Revision: 1.5 $ -->
<refentry id="function.sort">
<refnamediv>
<refname>sort</refname>
- <refpurpose>Sortuj tablicê</refpurpose>
+ <refpurpose>Sortuje tablicê</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<methodsynopsis>
- <type>void</type><methodname>sort</methodname>
-
<methodparam><type>array</type><parameter>tablica</parameter></methodparam>
+ <type>bool</type><methodname>sort</methodname>
+ <methodparam><type>array</type><parameter
role="reference">tablica</parameter></methodparam>
<methodparam
choice="opt"><type>int</type><parameter>flagi</parameter></methodparam>
</methodsynopsis>
<para>
Funkcja ta sortuje tablicê. Po zakoñczeniu dzia³ania funkcji
elementy bêd± u³o¿one od najmniejszego do najwiekszego.
+ </para>
+ <note>
+ <simpara>
+ Funkcja <function>sort</function> przypisuje nowe klucze do elementów
+ tablicy <parameter>tablica</parameter>. Wszystkie dotychczasowe klucze
+ zostan± usuniête.
+ </simpara>
+ </note>
+ <para>
+ &return.success;
+ </para>
+ <para>
<example>
<title>Przyk³ad u¿ycia <function>sort</function></title>
<programlisting role="php">
<![CDATA[
<?php
-$owoce = array ("cytryna", "pomarañca", "banan",
"jab³ko");
-sort ($owoce);
-reset ($owoce);
-while (list ($key, $val) = each ($owoce)) {
- echo "owoce[".$key."] = ".$val."\n";
+$owoce = array("cytryna", "pomarañcza", "banan",
"jab³ko");
+sort($owoce);
+reset($owoce);
+while (list($key, $val) = each($owoce)) {
+ echo "owoce[" . $key . "] = " . $val . "\n";
}
]]>
?>
</programlisting>
- </example>
- </para>
- <para>
- Ten przyk³ad wy¶wietli:
- </para>
- <para>
- <screen>
+ &example.output;
+ <screen>
<![CDATA[
owoce[0] = banan
owoce[1] = cytryna
owoce[2] = jab³ko
owoce[3] = pomarañcza
]]>
- </screen>
+ </screen>
+ </example>
</para>
<para>
Owoce zosta³y posortowane w porz±dku alfabetycznym.
@@ -57,16 +65,41 @@
Flagi typu sortowania:
<itemizedlist>
<listitem>
- <simpara>SORT_REGULAR - porównuj elementy normalnie</simpara>
+ <simpara>
+ <constant>SORT_REGULAR</constant> - porównuj elementy normalnie (nie zmienia
typów)
+ </simpara>
</listitem>
<listitem>
- <simpara>SORT_NUMERIC - porównuj elementy jako liczby</simpara>
+ <simpara>
+ <constant>SORT_NUMERIC</constant> - porównuj elementy jako liczby
+ </simpara>
</listitem>
<listitem>
- <simpara>SORT_STRING - porównuj elementy jako stringi</simpara>
+ <simpara>
+ <constant>SORT_STRING</constant> - porównuj elementy jako ci±gi
+ tekstowe
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <constant>SORT_LOCALE_STRING</constant> - porównuj elementy jako ci±gi
+ tekstowe, uwzglêdniaj±c ustawienia Locale. Dodane w PHP 5.0.2.
+ </simpara>
</listitem>
</itemizedlist>
</para>
+ <note>
+ <para>
+ Drugi parametr zosta³ dodany w PHP 4.
+ </para>
+ </note>
+ <warning>
+ <simpara>
+ Nale¿y zachowaæ ostro¿no¶æ przy sortowaniu funkcj±
+ <function>sort</function> tablic o ró¿nych typach elementów, poniewa¿
+ mo¿e to doprowadziæ do nieprzewidzianych wyników.
+ </simpara>
+ </warning>
<para>
Patrz tak¿e: <function>arsort</function>,
<function>asort</function>, <function>ksort</function>,
@@ -75,11 +108,6 @@
<function>array_multisort</function> i
<function>uksort</function>.
</para>
- <note>
- <para>
- Drugi parametr zosta³ dodany w PHP 4.
- </para>
- </note>
</refsect1>
</refentry>