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

From: 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>

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