cvs: phpdoc-it /reference/array/functions rsort.xml shuffle.xml sort.xml uasort.xml uksort.xml usort.xml
| From: | Marco Cucinato | Date: | Sat, 03 Jan 2004 15:35:20 +0000 |
| Subject: | cvs: phpdoc-it /reference/array/functions rsort.xml shuffle.xml sort.xml uasort.xml uksort.xml usort.xml | ||
| Groups: | php.doc.it | ||
| Request: | Send a blank email to doc-it+get-485@lists.php.net to get a copy of this message | ||
cucinato Sat Jan 3 10:35:20 2004 EDT
Modified files:
/phpdoc-it/reference/array/functions rsort.xml shuffle.xml sort.xml
uasort.xml uksort.xml
usort.xml
Log:
Sync to EN tree
Index: phpdoc-it/reference/array/functions/rsort.xml diff -u phpdoc-it/reference/array/functions/rsort.xml:1.3 phpdoc-it/reference/array/functions/rsort.xml:1.4 --- phpdoc-it/reference/array/functions/rsort.xml:1.3 Sun May 12 18:14:11 2002 +++ phpdoc-it/reference/array/functions/rsort.xml Sat Jan 3 10:35:19 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/array.xml, last change in rev 1.1 --> <!-- last change to 'rsort' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.4 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.8 Maintainer: cucinato Status: ready --> <!-- OLD-Revision: 1.173/EN.1.2 --> <refentry id="function.rsort"> <refnamediv> @@ -11,31 +11,35 @@ <refsect1> <title>Descrizione</title> <methodsynopsis> - <type>void</type><methodname>rsort</methodname> + <type>bool</type><methodname>rsort</methodname> <methodparam><type>array</type><parameter>array</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>sort_flags</parameter></methodparam> </methodsynopsis> <para> Questa funzione ordina un array in ordine decrescente. + </para> + <para> + &return.success; + </para> + <para> <example> <title>esempio di <function>rsort</function></title> <programlisting role="php"> <![CDATA[ -$frutti = array ("limone", "arancia", "banana", "mela"); -rsort ($frutti); -reset ($frutti); -while (list ($chiave, $valore) = each ($frutti)) { +<?php +$frutti = array("limone", "arancia", "banana", "mela"); +rsort($frutti); +reset($frutti); +while (list($chiave, $valore) = each($frutti)) { echo "$chiave = $valore\n"; } +?> ]]> </programlisting> - </example> - </para> - <para> - Questo esempio mostrerà: - </para> - <para> - <screen> + <para> + Questo esempio mostrerà: + </para> + <screen> <![CDATA[ 0 = mela 1 = limone @@ -43,12 +47,13 @@ 3 = arancia ]]> </screen> + </example> </para> <para> I frutti sono stati ordinati in ordine alfabetico decrescente. </para> <para> - Si può modificare il comportamento dell'ordinamento usando il parametro opzionale + Si può modificare il comportamento dell'ordinamento usando il parametro opzionale <parameter>sort_flags</parameter>, per maggiori dettagli vedere <function>sort</function>. </para> Index: phpdoc-it/reference/array/functions/shuffle.xml diff -u phpdoc-it/reference/array/functions/shuffle.xml:1.3 phpdoc-it/reference/array/functions/shuffle.xml:1.4 --- phpdoc-it/reference/array/functions/shuffle.xml:1.3 Sun May 12 18:14:11 2002 +++ phpdoc-it/reference/array/functions/shuffle.xml Sat Jan 3 10:35:19 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/array.xml, last change in rev 1.1 --> <!-- last change to 'shuffle' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.4 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.8 Maintainer: cucinato Status: ready --> <!-- OLD-Revision: 1.173/EN.1.2 --> <refentry id="function.shuffle"> <refnamediv> @@ -22,16 +22,21 @@ <title>esempio di <function>shuffle</function></title> <programlisting role="php"> <![CDATA[ -$numeri = range (1,20); -srand ((float)microtime()*1000000); -shuffle ($numeri); -while (list (, $numeero) = each ($numeri)) { +<?php +$numeri = range(1, 20); +srand((float)microtime() * 1000000); +shuffle($numeri); +while (list(, $numero) = each($numeri)) { echo "$numero "; } +?> ]]> </programlisting> </example> </para> + + ¬e.randomseed; + <para> Vedere anche <function>arsort</function>, <function>asort</function>, <function>ksort</function>, <function>rsort</function>, Index: phpdoc-it/reference/array/functions/sort.xml diff -u phpdoc-it/reference/array/functions/sort.xml:1.5 phpdoc-it/reference/array/functions/sort.xml:1.6 --- phpdoc-it/reference/array/functions/sort.xml:1.5 Fri Feb 21 12:48:53 2003 +++ phpdoc-it/reference/array/functions/sort.xml Sat Jan 3 10:35:19 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/array.xml, last change in rev 1.1 --> <!-- last change to 'sort' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.5 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.10 Maintainer: cucinato Status: ready --> <!-- OLD-Revision: 1.173/EN.1.2 --> <refentry id="function.sort"> <refnamediv> @@ -11,36 +11,45 @@ <refsect1> <title>Descrizione</title> <methodsynopsis> - <type>void</type><methodname>sort</methodname> + <type>bool</type><methodname>sort</methodname> <methodparam><type>array</type><parameter>array</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>sort_flags</parameter></methodparam> </methodsynopsis> <para> Questa funzione ordina un array. Gli elementi vengono disposti dal - più piccolo al più grande. + più piccolo al più grande. + </para> + <note> + <simpara> + Questa funzione assegna nuove chiavi agli elementi di + <parameter>array</parameter>. Quindi non si limita a riordinare le + chiavi, ma rimuove tutte le chiavi che siano state assegnate. + </simpara> + </note> + <para> + &return.success; + </para> + <para> <example> <title>esempio di <function>sort</function></title> <programlisting role="php"> <![CDATA[ <?php -$frutti = array ("limone", "arancia", "banana", "mela"); -sort ($frutti); -reset ($frutti); -while (list ($chiave, $valore) = each ($frutti)) { - echo "frutti[".$chiave."] = ".$valore."\n"; +$frutti = array("limone", "arancia", "banana", "mela"); +sort($frutti); +reset($frutti); +while (list($chiave, $valore) = each($frutti)) { + echo "frutti[" . $chiave . "] = " . $valore . "\n"; } ?> ]]> </programlisting> - </example> - </para> - <para> - Questo esempio mostrerà: - </para> - <para> - <screen> + <para> + Questo esempio mostrerà: + </para> + <screen> <![CDATA[ frutti[0] = arancia frutti[1] = banana @@ -48,6 +57,7 @@ frutti[3] = mela ]]> </screen> + </example> </para> <para> I frutti sono stati ordinati in ordine alfabetico. Index: phpdoc-it/reference/array/functions/uasort.xml diff -u phpdoc-it/reference/array/functions/uasort.xml:1.4 phpdoc-it/reference/array/functions/uasort.xml:1.5 --- phpdoc-it/reference/array/functions/uasort.xml:1.4 Tue Jan 7 13:09:32 2003 +++ phpdoc-it/reference/array/functions/uasort.xml Sat Jan 3 10:35:19 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/array.xml, last change in rev 1.1 --> <!-- last change to 'uasort' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.5 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.6 Maintainer: cucinato Status: ready --> <!-- OLD-Revision: 1.173/EN.1.2 --> <refentry id="function.uasort"> <refnamediv> @@ -14,7 +14,7 @@ <refsect1> <title>Descrizione</title> <methodsynopsis> - <type>void</type><methodname>uasort</methodname> + <type>bool</type><methodname>uasort</methodname> <methodparam><type>array</type><parameter>array</parameter></methodparam> <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> </methodsynopsis> @@ -25,6 +25,9 @@ l'ordine degli elementi è importante. La funzione di comparazione deve essere fornita dall'utente. </para> + <para> + &return.success; + </para> <note> <para> Vedere <function>usort</function> e @@ -32,9 +35,8 @@ di comparazione. </para> </note> - ¬e.func-callback; <para> - Vedere anche <function>usort</function>, <function>uksort</function>, + Vedere anche <function>usort</function>, <function>uksort</function>, <function>sort</function>, <function>asort</function>, <function>arsort</function>, <function>ksort</function> e <function>rsort</function>. Index: phpdoc-it/reference/array/functions/uksort.xml diff -u phpdoc-it/reference/array/functions/uksort.xml:1.4 phpdoc-it/reference/array/functions/uksort.xml:1.5 --- phpdoc-it/reference/array/functions/uksort.xml:1.4 Tue Jan 7 13:09:32 2003 +++ phpdoc-it/reference/array/functions/uksort.xml Sat Jan 3 10:35:19 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/array.xml, last change in rev 1.1 --> <!-- last change to 'uksort' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.5 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.11 Maintainer: cucinato Status: ready --> <!-- OLD-Revision: 1.173/EN.1.2 --> <refentry id="function.uksort"> <refnamediv> @@ -13,40 +13,54 @@ <refsect1> <title>Descrizione</title> <methodsynopsis> - <type>void</type><methodname>uksort</methodname> + <type>bool</type><methodname>uksort</methodname> <methodparam><type>array</type><parameter>array</parameter></methodparam> <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> </methodsynopsis> <para> - Ordina rispetto alle chiavi di un array mediante una + <function>uksort</function> ordina rispetto alle chiavi di un array mediante una funzione di comparazione definita dall'utente. Se si vuole ordinare un array con dei criteri non usuali, si deve usare questa funzione. </para> - <example> - <title>esempio di <function>uksort</function></title> - <programlisting role="php"> + <para> + La funzione <parameter>cmp_function</parameter> deve accettare due + parametri che saranno valorizzati con coppie di chiavi di <parameter>array</parameter>. + La funzione di confronto deve restituire un intero minore, uguale + o maggiore di zero se il primo argomento è considerato + minore, uguale o maggiore del + secondo. + </para> + <para> + &return.success; + </para> + <para> + <example> + <title>esempio di <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 => "quattro", 3 => "tre", 20 => "venti", 10 => "dieci"); +$a = array(4 => "quattro", 3 => "tre", 20 => "venti", 10 => "dieci"); -uksort ($a, "cmp"); +uksort($a, "cmp"); -while (list ($chiave, $valore) = each ($a)) { +while (list($chiave, $valore) = each($a)) { echo "$chiave: $valore\n"; } +?> ]]> </programlisting> - </example> - <para> - Questo esempio mostrerà: - </para> - <para> - <screen> + <para> + Questo esempio mostrerà: + </para> + <screen> <![CDATA[ 20: venti 10: dieci @@ -54,6 +68,7 @@ 3: tre ]]> </screen> + </example> </para> <para> Vedere anche <function>usort</function>, <function>uasort</function>, Index: phpdoc-it/reference/array/functions/usort.xml diff -u phpdoc-it/reference/array/functions/usort.xml:1.8 phpdoc-it/reference/array/functions/usort.xml:1.9 --- phpdoc-it/reference/array/functions/usort.xml:1.8 Mon Nov 17 19:04:36 2003 +++ phpdoc-it/reference/array/functions/usort.xml Sat Jan 3 10:35:19 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/array.xml, last change in rev 1.1 --> <!-- last change to 'usort' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.13 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.16 Maintainer: cucinato Status: ready --> <!-- OLD-Revision: 1.173/EN.1.2 --> <refentry id="function.usort"> <refnamediv> @@ -13,7 +13,7 @@ <refsect1> <title>Descrizione</title> <methodsynopsis> - <type>void</type><methodname>usort</methodname> + <type>bool</type><methodname>usort</methodname> <methodparam><type>array</type><parameter>array</parameter></methodparam> <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> </methodsynopsis> @@ -38,6 +38,9 @@ non succede più dal momento che non c'è un modo per ottenerlo in maniera efficiente. </para> </note> + </para> + <para> + &return.success; </para> <para> <example> @@ -90,7 +93,7 @@ <programlisting role="php"> <![CDATA[ <?php -function cmp ($a, $b) { +function cmp($a, $b) { return strcmp($a["frutto"], $b["frutto"]); } @@ -130,18 +133,16 @@ </title> <programlisting role="php"> <![CDATA[ -<? +<?php class OggettoTest { var $nome; - function OggettoTest($nome) - { + function OggettoTest($nome) { $this->nome = $nome; } /* Questa è la funzione statica di comparazione: */ - function comp_ogg($a, $b) - { + function comp_ogg($a, $b) { $al = strtolower($a->nome); $bl = strtolower($b->nome); if ($al == $bl) { @@ -158,7 +159,7 @@ usort($a, array("OggettoTest", "comp_ogg")); foreach ($a as $voce) { - print $voce->nome."\n"; + echo $voce->nome."\n"; } ?> ]]>
Index: phpdoc-it/reference/array/functions/rsort.xml diff -u phpdoc-it/reference/array/functions/rsort.xml:1.3 phpdoc-it/reference/array/functions/rsort.xml:1.4 --- phpdoc-it/reference/array/functions/rsort.xml:1.3 Sun May 12 18:14:11 2002 +++ phpdoc-it/reference/array/functions/rsort.xml Sat Jan 3 10:35:19 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/array.xml, last change in rev 1.1 --> <!-- last change to 'rsort' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.4 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.8 Maintainer: cucinato Status: ready --> <!-- OLD-Revision: 1.173/EN.1.2 --> <refentry id="function.rsort"> <refnamediv> @@ -11,31 +11,35 @@ <refsect1> <title>Descrizione</title> <methodsynopsis> - <type>void</type><methodname>rsort</methodname> + <type>bool</type><methodname>rsort</methodname> <methodparam><type>array</type><parameter>array</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>sort_flags</parameter></methodparam> </methodsynopsis> <para> Questa funzione ordina un array in ordine decrescente. + </para> + <para> + &return.success; + </para> + <para> <example> <title>esempio di <function>rsort</function></title> <programlisting role="php"> <![CDATA[ -$frutti = array ("limone", "arancia", "banana", "mela"); -rsort ($frutti); -reset ($frutti); -while (list ($chiave, $valore) = each ($frutti)) { +<?php +$frutti = array("limone", "arancia", "banana", "mela"); +rsort($frutti); +reset($frutti); +while (list($chiave, $valore) = each($frutti)) { echo "$chiave = $valore\n"; } +?> ]]> </programlisting> - </example> - </para> - <para> - Questo esempio mostrerà: - </para> - <para> - <screen> + <para> + Questo esempio mostrerà: + </para> + <screen> <![CDATA[ 0 = mela 1 = limone @@ -43,12 +47,13 @@ 3 = arancia ]]> </screen> + </example> </para> <para> I frutti sono stati ordinati in ordine alfabetico decrescente. </para> <para> - Si può modificare il comportamento dell'ordinamento usando il parametro opzionale + Si può modificare il comportamento dell'ordinamento usando il parametro opzionale <parameter>sort_flags</parameter>, per maggiori dettagli vedere <function>sort</function>. </para> Index: phpdoc-it/reference/array/functions/shuffle.xml diff -u phpdoc-it/reference/array/functions/shuffle.xml:1.3 phpdoc-it/reference/array/functions/shuffle.xml:1.4 --- phpdoc-it/reference/array/functions/shuffle.xml:1.3 Sun May 12 18:14:11 2002 +++ phpdoc-it/reference/array/functions/shuffle.xml Sat Jan 3 10:35:19 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/array.xml, last change in rev 1.1 --> <!-- last change to 'shuffle' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.4 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.8 Maintainer: cucinato Status: ready --> <!-- OLD-Revision: 1.173/EN.1.2 --> <refentry id="function.shuffle"> <refnamediv> @@ -22,16 +22,21 @@ <title>esempio di <function>shuffle</function></title> <programlisting role="php"> <![CDATA[ -$numeri = range (1,20); -srand ((float)microtime()*1000000); -shuffle ($numeri); -while (list (, $numeero) = each ($numeri)) { +<?php +$numeri = range(1, 20); +srand((float)microtime() * 1000000); +shuffle($numeri); +while (list(, $numero) = each($numeri)) { echo "$numero "; } +?> ]]> </programlisting> </example> </para> + + ¬e.randomseed; + <para> Vedere anche <function>arsort</function>, <function>asort</function>, <function>ksort</function>, <function>rsort</function>, Index: phpdoc-it/reference/array/functions/sort.xml diff -u phpdoc-it/reference/array/functions/sort.xml:1.5 phpdoc-it/reference/array/functions/sort.xml:1.6 --- phpdoc-it/reference/array/functions/sort.xml:1.5 Fri Feb 21 12:48:53 2003 +++ phpdoc-it/reference/array/functions/sort.xml Sat Jan 3 10:35:19 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/array.xml, last change in rev 1.1 --> <!-- last change to 'sort' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.5 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.10 Maintainer: cucinato Status: ready --> <!-- OLD-Revision: 1.173/EN.1.2 --> <refentry id="function.sort"> <refnamediv> @@ -11,36 +11,45 @@ <refsect1> <title>Descrizione</title> <methodsynopsis> - <type>void</type><methodname>sort</methodname> + <type>bool</type><methodname>sort</methodname> <methodparam><type>array</type><parameter>array</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>sort_flags</parameter></methodparam> </methodsynopsis> <para> Questa funzione ordina un array. Gli elementi vengono disposti dal - più piccolo al più grande. + più piccolo al più grande. + </para> + <note> + <simpara> + Questa funzione assegna nuove chiavi agli elementi di + <parameter>array</parameter>. Quindi non si limita a riordinare le + chiavi, ma rimuove tutte le chiavi che siano state assegnate. + </simpara> + </note> + <para> + &return.success; + </para> + <para> <example> <title>esempio di <function>sort</function></title> <programlisting role="php"> <![CDATA[ <?php -$frutti = array ("limone", "arancia", "banana", "mela"); -sort ($frutti); -reset ($frutti); -while (list ($chiave, $valore) = each ($frutti)) { - echo "frutti[".$chiave."] = ".$valore."\n"; +$frutti = array("limone", "arancia", "banana", "mela"); +sort($frutti); +reset($frutti); +while (list($chiave, $valore) = each($frutti)) { + echo "frutti[" . $chiave . "] = " . $valore . "\n"; } ?> ]]> </programlisting> - </example> - </para> - <para> - Questo esempio mostrerà: - </para> - <para> - <screen> + <para> + Questo esempio mostrerà: + </para> + <screen> <![CDATA[ frutti[0] = arancia frutti[1] = banana @@ -48,6 +57,7 @@ frutti[3] = mela ]]> </screen> + </example> </para> <para> I frutti sono stati ordinati in ordine alfabetico. Index: phpdoc-it/reference/array/functions/uasort.xml diff -u phpdoc-it/reference/array/functions/uasort.xml:1.4 phpdoc-it/reference/array/functions/uasort.xml:1.5 --- phpdoc-it/reference/array/functions/uasort.xml:1.4 Tue Jan 7 13:09:32 2003 +++ phpdoc-it/reference/array/functions/uasort.xml Sat Jan 3 10:35:19 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/array.xml, last change in rev 1.1 --> <!-- last change to 'uasort' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.5 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.6 Maintainer: cucinato Status: ready --> <!-- OLD-Revision: 1.173/EN.1.2 --> <refentry id="function.uasort"> <refnamediv> @@ -14,7 +14,7 @@ <refsect1> <title>Descrizione</title> <methodsynopsis> - <type>void</type><methodname>uasort</methodname> + <type>bool</type><methodname>uasort</methodname> <methodparam><type>array</type><parameter>array</parameter></methodparam> <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> </methodsynopsis> @@ -25,6 +25,9 @@ l'ordine degli elementi è importante. La funzione di comparazione deve essere fornita dall'utente. </para> + <para> + &return.success; + </para> <note> <para> Vedere <function>usort</function> e @@ -32,9 +35,8 @@ di comparazione. </para> </note> - ¬e.func-callback; <para> - Vedere anche <function>usort</function>, <function>uksort</function>, + Vedere anche <function>usort</function>, <function>uksort</function>, <function>sort</function>, <function>asort</function>, <function>arsort</function>, <function>ksort</function> e <function>rsort</function>. Index: phpdoc-it/reference/array/functions/uksort.xml diff -u phpdoc-it/reference/array/functions/uksort.xml:1.4 phpdoc-it/reference/array/functions/uksort.xml:1.5 --- phpdoc-it/reference/array/functions/uksort.xml:1.4 Tue Jan 7 13:09:32 2003 +++ phpdoc-it/reference/array/functions/uksort.xml Sat Jan 3 10:35:19 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/array.xml, last change in rev 1.1 --> <!-- last change to 'uksort' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.5 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.11 Maintainer: cucinato Status: ready --> <!-- OLD-Revision: 1.173/EN.1.2 --> <refentry id="function.uksort"> <refnamediv> @@ -13,40 +13,54 @@ <refsect1> <title>Descrizione</title> <methodsynopsis> - <type>void</type><methodname>uksort</methodname> + <type>bool</type><methodname>uksort</methodname> <methodparam><type>array</type><parameter>array</parameter></methodparam> <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> </methodsynopsis> <para> - Ordina rispetto alle chiavi di un array mediante una + <function>uksort</function> ordina rispetto alle chiavi di un array mediante una funzione di comparazione definita dall'utente. Se si vuole ordinare un array con dei criteri non usuali, si deve usare questa funzione. </para> - <example> - <title>esempio di <function>uksort</function></title> - <programlisting role="php"> + <para> + La funzione <parameter>cmp_function</parameter> deve accettare due + parametri che saranno valorizzati con coppie di chiavi di <parameter>array</parameter>. + La funzione di confronto deve restituire un intero minore, uguale + o maggiore di zero se il primo argomento è considerato + minore, uguale o maggiore del + secondo. + </para> + <para> + &return.success; + </para> + <para> + <example> + <title>esempio di <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 => "quattro", 3 => "tre", 20 => "venti", 10 => "dieci"); +$a = array(4 => "quattro", 3 => "tre", 20 => "venti", 10 => "dieci"); -uksort ($a, "cmp"); +uksort($a, "cmp"); -while (list ($chiave, $valore) = each ($a)) { +while (list($chiave, $valore) = each($a)) { echo "$chiave: $valore\n"; } +?> ]]> </programlisting> - </example> - <para> - Questo esempio mostrerà: - </para> - <para> - <screen> + <para> + Questo esempio mostrerà: + </para> + <screen> <![CDATA[ 20: venti 10: dieci @@ -54,6 +68,7 @@ 3: tre ]]> </screen> + </example> </para> <para> Vedere anche <function>usort</function>, <function>uasort</function>, Index: phpdoc-it/reference/array/functions/usort.xml diff -u phpdoc-it/reference/array/functions/usort.xml:1.8 phpdoc-it/reference/array/functions/usort.xml:1.9 --- phpdoc-it/reference/array/functions/usort.xml:1.8 Mon Nov 17 19:04:36 2003 +++ phpdoc-it/reference/array/functions/usort.xml Sat Jan 3 10:35:19 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/array.xml, last change in rev 1.1 --> <!-- last change to 'usort' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.13 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.16 Maintainer: cucinato Status: ready --> <!-- OLD-Revision: 1.173/EN.1.2 --> <refentry id="function.usort"> <refnamediv> @@ -13,7 +13,7 @@ <refsect1> <title>Descrizione</title> <methodsynopsis> - <type>void</type><methodname>usort</methodname> + <type>bool</type><methodname>usort</methodname> <methodparam><type>array</type><parameter>array</parameter></methodparam> <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> </methodsynopsis> @@ -38,6 +38,9 @@ non succede più dal momento che non c'è un modo per ottenerlo in maniera efficiente. </para> </note> + </para> + <para> + &return.success; </para> <para> <example> @@ -90,7 +93,7 @@ <programlisting role="php"> <![CDATA[ <?php -function cmp ($a, $b) { +function cmp($a, $b) { return strcmp($a["frutto"], $b["frutto"]); } @@ -130,18 +133,16 @@ </title> <programlisting role="php"> <![CDATA[ -<? +<?php class OggettoTest { var $nome; - function OggettoTest($nome) - { + function OggettoTest($nome) { $this->nome = $nome; } /* Questa è la funzione statica di comparazione: */ - function comp_ogg($a, $b) - { + function comp_ogg($a, $b) { $al = strtolower($a->nome); $bl = strtolower($b->nome); if ($al == $bl) { @@ -158,7 +159,7 @@ usort($a, array("OggettoTest", "comp_ogg")); foreach ($a as $voce) { - print $voce->nome."\n"; + echo $voce->nome."\n"; } ?> ]]>