cvs: phpdoc-it /reference/array/functions array.xml count.xml natsort.xml usort.xml
| From: | Marco Cucinato | Date: | Tue, 18 Nov 2003 00:04:36 +0000 |
| Subject: | cvs: phpdoc-it /reference/array/functions array.xml count.xml natsort.xml usort.xml | ||
| Groups: | php.doc.it | ||
| Request: | Send a blank email to doc-it+get-472@lists.php.net to get a copy of this message | ||
cucinato Mon Nov 17 19:04:36 2003 EDT
Modified files:
/phpdoc-it/reference/array/functions array.xml count.xml
natsort.xml usort.xml
Log:
Sync to EN tree
Index: phpdoc-it/reference/array/functions/array.xml diff -u phpdoc-it/reference/array/functions/array.xml:1.5 phpdoc-it/reference/array/functions/array.xml:1.6 --- phpdoc-it/reference/array/functions/array.xml:1.5 Mon Jun 2 05:25:37 2003 +++ phpdoc-it/reference/array/functions/array.xml Mon Nov 17 19:04:36 2003 @@ -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 'array' in en/ tree in rev 1.110 --> -<!-- EN-Revision: 1.7 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.11 Maintainer: cucinato Status: ready --> <!-- OLD-Revision: 1.173/EN.1.110 --> <refentry id="function.array"> <refnamediv> @@ -17,7 +17,7 @@ <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> </methodsynopsis> <para> - Restituisce un array contenente i parametri. Ai parametri si può dare + Restituisce un array contenente i parametri. Ai parametri si può dare un indice con l'operatore <literal>=></literal>. Leggere la sezione relativa ai <link linkend="language.types.array">tipi</link> per ulteriori informazioni sugli array. @@ -32,10 +32,10 @@ </para> <para> La sintassi "indice => valori", separati da virgole, definisce indici - e valori. indice può essere di tipo string o numerico. Quando l'indice è + e valori. indice può essere di tipo string o numerico. Quando l'indice è omesso, viene generato automaticamente un indice intero, a partire - da 0. Se l'indice è un intero, il successivo indice generato sarà - l'indice intero più grande + 1. Si noti che quando due indici + da 0. Se l'indice è un intero, il successivo indice generato sarà + l'indice intero più grande + 1. Si noti che quando due indici identici vengono definiti, l'ultimo sovrascrive il primo. </para> <para> @@ -49,9 +49,9 @@ <![CDATA[ <?php $frutta = array ( - "frutta" => array ("a"=>"arancia", "b"=>"banana", "c"=>"mela"), - "numeri" => array (1, 2, 3, 4, 5, 6), - "buche" => array ("prima", 5 => "seconda", "terza") + "frutta" => array("a" => "arancia", "b" => "banana", "c" => "mela"), + "numeri" => array(1, 2, 3, 4, 5, 6), + "buche" => array("prima", 5 => "seconda", "terza") ) ?> ]]> @@ -64,14 +64,15 @@ <programlisting role="php"> <![CDATA[ <?php -$array = array( 1, 1, 1, 1, 1, 8=>1, 4=>1, 19, 3=>13); +$array = array(1, 1, 1, 1, 1, 8 => 1, 4 => 1, 19, 3 => 13); print_r($array); ?> ]]> </programlisting> <para> che stamperà: - <screen role="php"> + </para> + <screen role="php"> <![CDATA[ Array ( @@ -84,12 +85,13 @@ [9] => 19 ) ]]> - </screen> - </para> + </screen> </example> + </para> + <para> Si noti che l'indice '3' è definito due volte, e che mantiene il valore finale 13. - L'indice 4 è definito dopo l'indice 8, e il successivo indice generato (valore 19) - è 9, dal momento che l'indice più grande era 8. + L'indice 4 è definito dopo l'indice 8, e il successivo indice generato (valore 19) + è 9, dal momento che l'indice più grande era 8. </para> <para> Questo esempio crea un array che parte da 1 (1-based). @@ -98,14 +100,15 @@ <programlisting role="php"> <![CDATA[ <?php -$primotrimestre = array(1 => 'Gennaio', 'Febbraio', 'Marzo'); +$primotrimestre = array(1 => 'Gennaio', 'Febbraio', 'Marzo'); print_r($primotrimestre); ?> ]]> </programlisting> <para> che stamperà: - <screen> + </para> + <screen> <![CDATA[ Array ( @@ -114,8 +117,7 @@ [3] => Marzo ) ]]> - </screen> - </para> + </screen> </example> </para> <para> Index: phpdoc-it/reference/array/functions/count.xml diff -u phpdoc-it/reference/array/functions/count.xml:1.3 phpdoc-it/reference/array/functions/count.xml:1.4 --- phpdoc-it/reference/array/functions/count.xml:1.3 Sun May 12 18:14:11 2002 +++ phpdoc-it/reference/array/functions/count.xml Mon Nov 17 19:04:36 2003 @@ -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 'count' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.4 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.9 Maintainer: cucinato Status: ready --> <!-- OLD-Revision: 1.173/EN.1.2 --> <refentry id="function.count"> <refnamediv> @@ -13,25 +13,39 @@ <methodsynopsis> <type>int</type><methodname>count</methodname> <methodparam><type>mixed</type><parameter>var</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> </methodsynopsis> <para> Restituisce il numero di elementi in <parameter>var</parameter>, - la quale è di norma un array (dal momento che qualsiasi altro oggetto avrà un + la quale è di norma un array (dal momento che qualsiasi altro oggetto avrà un elemento). </para> <para> - Se <parameter>var</parameter> non è un array, verrà restituito <literal>1</literal> + Se <parameter>var</parameter> non è un array, verrà restituito <literal>1</literal> (eccezione: <literal>count(&null;)</literal> restituisce <literal>0</literal>). </para> - <warning> + <note> + <simpara> + Il parametro opzionale <parameter>mode</parameter> è disponibile da + PHP 4.2.0. + </simpara> + </note> + <para> + Se il parametro opzionale <parameter>mode</parameter> è impostato a + <constant>COUNT_RECURSIVE</constant> (o 1), <function>count</function> + conterà ricorsivamente l'array. Questo è utile in particolare per + contare tutti gli elementi di un array multidimensionale. Il valore di + default per <parameter>mode</parameter> è <literal>0</literal>. + </para> + <caution> <para> - <function>count</function> può restituire 0 per una variabile che - non è impostata, ma può anche restituire 0 per una variabile che è + <function>count</function> può restituire 0 per una variabile che + non è impostata, ma può anche restituire 0 per una variabile che è stata inizializzata con un array vuoto. Usare - <function>isset</function> per verificare se una variabile è impostata. + <function>isset</function> per verificare se una variabile è impostata. </para> - </warning> + </caution> <para> Vedere la sezione <link linkend="language.types.array">Arrays</link> nel manuale per una spiegazione dettagliata di come gli array siano @@ -43,27 +57,51 @@ <programlisting role="php"> <!-- TODO: examples about count(null), count(false), count(object).. --> <![CDATA[ +<?php $a[0] = 1; $a[1] = 3; $a[2] = 5; -$risultato = count ($a); +$risultato = count($a); //$risultato == 3 -$b[0] = 7; -$b[5] = 9; +$b[0] = 7; +$b[5] = 9; $b[10] = 11; -$risultato = count ($b); +$risultato = count($b); // $risultato == 3; +?> ]]> </programlisting> </example> </para> - <note> <para> - La funzione <function>sizeof</function> è un - <link linkend="aliases">alias</link> per <function>count</function>. + <example> + <title> + esempio di <function>count</function> ricorsiva (PHP >= 4.2.0) + </title> + <programlisting role="php"> +<![CDATA[ +<?php +$cibo = array('frutta' => array('arancia', 'banana', 'mela'), + 'verdura' => array('carota', 'zucchina', 'piselli')); + +// conteggio ricorsivo +echo count($cibp,COUNT_RECURSIVE); // output 8 + +// conteggio normale +echo count($cibo); // output 2 + +?> +]]> + </programlisting> + </example> </para> - </note> + <note> + <para> + La funzione <function>sizeof</function> è un + <link linkend="aliases">alias</link> per <function>count</function>. + </para> + </note> <para> Vedere anche <function>is_array</function>, <function>isset</function> e Index: phpdoc-it/reference/array/functions/natsort.xml diff -u phpdoc-it/reference/array/functions/natsort.xml:1.4 phpdoc-it/reference/array/functions/natsort.xml:1.5 --- phpdoc-it/reference/array/functions/natsort.xml:1.4 Tue Jul 16 22:22:41 2002 +++ phpdoc-it/reference/array/functions/natsort.xml Mon Nov 17 19:04:36 2003 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/array.xml, last change in rev 1.6 --> <!-- last change to 'natsort' in en/ tree in rev 1.25 --> -<!-- EN-Revision: 1.5 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.8 Maintainer: cucinato Status: ready --> <!-- OLD-Revision: 1.173/EN.1.25 --> <refentry id="function.natsort"> <refnamediv> @@ -29,7 +29,7 @@ <programlisting role="php"> <![CDATA[ <?php -$array1 = $array2 = array ("img12.png", "img10.png", "img2.png", "img1.png"); +$array1 = $array2 = array("img12.png", "img10.png", "img2.png", "img1.png"); sort($array1); echo "Ordinamento standard\n"; @@ -41,13 +41,10 @@ ?> ]]> </programlisting> - </example> - </para> - <para> - Questo codice genererà il seguente risultato: - </para> - <para> - <screen> + <para> + Questo codice genererà il seguente risultato: + </para> + <screen> <![CDATA[ Ordinamento standard Array @@ -67,11 +64,20 @@ [0] => img12.png ) ]]> - </screen> - Per ulteriori informazioni vedere la pagina di Martin Pool <ulink - url="&url.strnatcmp;">Natural Order String Comparison</ulink> - . + </screen> + <para> + Per ulteriori informazioni vedere la pagina di Martin Pool <ulink + url="&url.strnatcmp;">Natural Order String Comparison</ulink> + . + </para> + </example> </para> + <note> + <para> + Se si vogliono mantenere le associazione tra indici e valori, + utilizzare <literal>uasort($arr, 'strnatcmp')</literal>. + </para> + </note> <para> Vedere anche <function>natcasesort</function>, <function>strnatcmp</function> e Index: phpdoc-it/reference/array/functions/usort.xml diff -u phpdoc-it/reference/array/functions/usort.xml:1.7 phpdoc-it/reference/array/functions/usort.xml:1.8 --- phpdoc-it/reference/array/functions/usort.xml:1.7 Sun Feb 9 15:58:51 2003 +++ phpdoc-it/reference/array/functions/usort.xml Mon Nov 17 19:04:36 2003 @@ -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.8 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.13 Maintainer: cucinato Status: ready --> <!-- OLD-Revision: 1.173/EN.1.2 --> <refentry id="function.usort"> <refnamediv> @@ -28,12 +28,14 @@ o superiore a zero se il primo elemento è da considerarsi rispettivamente minore, uguale o maggiore del secondo. + </para> + <para> <note> <para> - Se due parametri vengono valutati come uguali, il loro ordinamento nell'array ordinato è indefinito. - Fino al PHP 4.0.6 le funzioni definite dall'utente mantenevano l'ordine originario per - questi elementi, ma con il nuovo algoritmo di ordinamento introdotto con la versione 4.1.0 questo - non succede più dal momento che non c'è un modo per ottenerlo in maniera efficiente. + Se due parametri vengono valutati come uguali, il loro ordinamento nell'array ordinato è indefinito. + Fino al PHP 4.0.6 le funzioni definite dall'utente mantenevano l'ordine originario per + questi elementi, ma con il nuovo algoritmo di ordinamento introdotto con la versione 4.1.0 questo + non succede più dal momento che non c'è un modo per ottenerlo in maniera efficiente. </para> </note> </para> @@ -42,39 +44,41 @@ <title>esempio di <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 ($chiave, $valore) = each ($a)) { +while (list($chiave, $valore) = each($a)) { echo "$chiave: $valore\n"; } +?> ]]> </programlisting> - </example> - </para> - <para> - Questo esempio mostrerà: - </para> - <para> - <screen> + <para> + Questo esempio mostrerà: + </para> + <screen> <![CDATA[ -0: 6 -1: 5 +0: 1 +1: 2 2: 3 -3: 2 -4: 1 +3: 5 +4: 6 ]]> - </screen> + </screen> + </example> </para> <note> <para> - Ovviamente, in questo caso banale di ordinamento decrescente la funzione <function>rsort</function> + Ovviamente, in questo caso banale di ordinamento decrescente la funzione <function>sort</function> sarebbe stata più appropriata. </para> </note> @@ -85,6 +89,7 @@ </title> <programlisting role="php"> <![CDATA[ +<?php function cmp ($a, $b) { return strcmp($a["frutto"], $b["frutto"]); } @@ -95,28 +100,27 @@ usort($frutti, "cmp"); -while (list ($chiave, $valore) = each ($frutti)) { +while (list($chiave, $valore) = each($frutti)) { echo "\$frutti[$chiave]: " . $valore["frutto"] . "\n"; } +?> ]]> </programlisting> - </example> - </para> - <para> - Quando si ordina un array multidimensionale, $a e $b contengono - riferimenti al primo indice dell'array. - </para> - <para> - Questo esempio mostrerà: - </para> - <para> - <screen> + <para> + Quando si ordina un array multidimensionale, $a e $b contengono + riferimenti al primo indice dell'array. + </para> + <para> + Questo esempio mostrerà: + </para> + <screen> <![CDATA[ $frutti[0]: arance $frutti[1]: limoni $frutti[2]: uva ]]> - </screen> + </screen> + </example> </para> <para> @@ -126,6 +130,7 @@ </title> <programlisting role="php"> <![CDATA[ +<? class OggettoTest { var $nome; @@ -139,7 +144,9 @@ { $al = strtolower($a->nome); $bl = strtolower($b->nome); - if ($al == $bl) return 0; + if ($al == $bl) { + return 0; + } return ($al > $bl) ? +1 : -1; } } @@ -148,26 +155,25 @@ $a[] = new OggettoTest("b"); $a[] = new OggettoTest("d"); -uasort($a, array ("OggettoTest", "comp_ogg")); +usort($a, array("OggettoTest", "comp_ogg")); foreach ($a as $voce) { print $voce->nome."\n"; } +?> ]]> </programlisting> - </example> - </para> - <para> - Questo esempio mostrerà: - </para> - <para> - <screen> + <para> + Questo esempio mostrerà: + </para> + <screen> <![CDATA[ b c d ]]> - </screen> + </screen> + </example> </para> <para>
Index: phpdoc-it/reference/array/functions/array.xml diff -u phpdoc-it/reference/array/functions/array.xml:1.5 phpdoc-it/reference/array/functions/array.xml:1.6 --- phpdoc-it/reference/array/functions/array.xml:1.5 Mon Jun 2 05:25:37 2003 +++ phpdoc-it/reference/array/functions/array.xml Mon Nov 17 19:04:36 2003 @@ -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 'array' in en/ tree in rev 1.110 --> -<!-- EN-Revision: 1.7 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.11 Maintainer: cucinato Status: ready --> <!-- OLD-Revision: 1.173/EN.1.110 --> <refentry id="function.array"> <refnamediv> @@ -17,7 +17,7 @@ <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> </methodsynopsis> <para> - Restituisce un array contenente i parametri. Ai parametri si può dare + Restituisce un array contenente i parametri. Ai parametri si può dare un indice con l'operatore <literal>=></literal>. Leggere la sezione relativa ai <link linkend="language.types.array">tipi</link> per ulteriori informazioni sugli array. @@ -32,10 +32,10 @@ </para> <para> La sintassi "indice => valori", separati da virgole, definisce indici - e valori. indice può essere di tipo string o numerico. Quando l'indice è + e valori. indice può essere di tipo string o numerico. Quando l'indice è omesso, viene generato automaticamente un indice intero, a partire - da 0. Se l'indice è un intero, il successivo indice generato sarà - l'indice intero più grande + 1. Si noti che quando due indici + da 0. Se l'indice è un intero, il successivo indice generato sarà + l'indice intero più grande + 1. Si noti che quando due indici identici vengono definiti, l'ultimo sovrascrive il primo. </para> <para> @@ -49,9 +49,9 @@ <![CDATA[ <?php $frutta = array ( - "frutta" => array ("a"=>"arancia", "b"=>"banana", "c"=>"mela"), - "numeri" => array (1, 2, 3, 4, 5, 6), - "buche" => array ("prima", 5 => "seconda", "terza") + "frutta" => array("a" => "arancia", "b" => "banana", "c" => "mela"), + "numeri" => array(1, 2, 3, 4, 5, 6), + "buche" => array("prima", 5 => "seconda", "terza") ) ?> ]]> @@ -64,14 +64,15 @@ <programlisting role="php"> <![CDATA[ <?php -$array = array( 1, 1, 1, 1, 1, 8=>1, 4=>1, 19, 3=>13); +$array = array(1, 1, 1, 1, 1, 8 => 1, 4 => 1, 19, 3 => 13); print_r($array); ?> ]]> </programlisting> <para> che stamperà: - <screen role="php"> + </para> + <screen role="php"> <![CDATA[ Array ( @@ -84,12 +85,13 @@ [9] => 19 ) ]]> - </screen> - </para> + </screen> </example> + </para> + <para> Si noti che l'indice '3' è definito due volte, e che mantiene il valore finale 13. - L'indice 4 è definito dopo l'indice 8, e il successivo indice generato (valore 19) - è 9, dal momento che l'indice più grande era 8. + L'indice 4 è definito dopo l'indice 8, e il successivo indice generato (valore 19) + è 9, dal momento che l'indice più grande era 8. </para> <para> Questo esempio crea un array che parte da 1 (1-based). @@ -98,14 +100,15 @@ <programlisting role="php"> <![CDATA[ <?php -$primotrimestre = array(1 => 'Gennaio', 'Febbraio', 'Marzo'); +$primotrimestre = array(1 => 'Gennaio', 'Febbraio', 'Marzo'); print_r($primotrimestre); ?> ]]> </programlisting> <para> che stamperà: - <screen> + </para> + <screen> <![CDATA[ Array ( @@ -114,8 +117,7 @@ [3] => Marzo ) ]]> - </screen> - </para> + </screen> </example> </para> <para> Index: phpdoc-it/reference/array/functions/count.xml diff -u phpdoc-it/reference/array/functions/count.xml:1.3 phpdoc-it/reference/array/functions/count.xml:1.4 --- phpdoc-it/reference/array/functions/count.xml:1.3 Sun May 12 18:14:11 2002 +++ phpdoc-it/reference/array/functions/count.xml Mon Nov 17 19:04:36 2003 @@ -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 'count' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.4 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.9 Maintainer: cucinato Status: ready --> <!-- OLD-Revision: 1.173/EN.1.2 --> <refentry id="function.count"> <refnamediv> @@ -13,25 +13,39 @@ <methodsynopsis> <type>int</type><methodname>count</methodname> <methodparam><type>mixed</type><parameter>var</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> </methodsynopsis> <para> Restituisce il numero di elementi in <parameter>var</parameter>, - la quale è di norma un array (dal momento che qualsiasi altro oggetto avrà un + la quale è di norma un array (dal momento che qualsiasi altro oggetto avrà un elemento). </para> <para> - Se <parameter>var</parameter> non è un array, verrà restituito <literal>1</literal> + Se <parameter>var</parameter> non è un array, verrà restituito <literal>1</literal> (eccezione: <literal>count(&null;)</literal> restituisce <literal>0</literal>). </para> - <warning> + <note> + <simpara> + Il parametro opzionale <parameter>mode</parameter> è disponibile da + PHP 4.2.0. + </simpara> + </note> + <para> + Se il parametro opzionale <parameter>mode</parameter> è impostato a + <constant>COUNT_RECURSIVE</constant> (o 1), <function>count</function> + conterà ricorsivamente l'array. Questo è utile in particolare per + contare tutti gli elementi di un array multidimensionale. Il valore di + default per <parameter>mode</parameter> è <literal>0</literal>. + </para> + <caution> <para> - <function>count</function> può restituire 0 per una variabile che - non è impostata, ma può anche restituire 0 per una variabile che è + <function>count</function> può restituire 0 per una variabile che + non è impostata, ma può anche restituire 0 per una variabile che è stata inizializzata con un array vuoto. Usare - <function>isset</function> per verificare se una variabile è impostata. + <function>isset</function> per verificare se una variabile è impostata. </para> - </warning> + </caution> <para> Vedere la sezione <link linkend="language.types.array">Arrays</link> nel manuale per una spiegazione dettagliata di come gli array siano @@ -43,27 +57,51 @@ <programlisting role="php"> <!-- TODO: examples about count(null), count(false), count(object).. --> <![CDATA[ +<?php $a[0] = 1; $a[1] = 3; $a[2] = 5; -$risultato = count ($a); +$risultato = count($a); //$risultato == 3 -$b[0] = 7; -$b[5] = 9; +$b[0] = 7; +$b[5] = 9; $b[10] = 11; -$risultato = count ($b); +$risultato = count($b); // $risultato == 3; +?> ]]> </programlisting> </example> </para> - <note> <para> - La funzione <function>sizeof</function> è un - <link linkend="aliases">alias</link> per <function>count</function>. + <example> + <title> + esempio di <function>count</function> ricorsiva (PHP >= 4.2.0) + </title> + <programlisting role="php"> +<![CDATA[ +<?php +$cibo = array('frutta' => array('arancia', 'banana', 'mela'), + 'verdura' => array('carota', 'zucchina', 'piselli')); + +// conteggio ricorsivo +echo count($cibp,COUNT_RECURSIVE); // output 8 + +// conteggio normale +echo count($cibo); // output 2 + +?> +]]> + </programlisting> + </example> </para> - </note> + <note> + <para> + La funzione <function>sizeof</function> è un + <link linkend="aliases">alias</link> per <function>count</function>. + </para> + </note> <para> Vedere anche <function>is_array</function>, <function>isset</function> e Index: phpdoc-it/reference/array/functions/natsort.xml diff -u phpdoc-it/reference/array/functions/natsort.xml:1.4 phpdoc-it/reference/array/functions/natsort.xml:1.5 --- phpdoc-it/reference/array/functions/natsort.xml:1.4 Tue Jul 16 22:22:41 2002 +++ phpdoc-it/reference/array/functions/natsort.xml Mon Nov 17 19:04:36 2003 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/array.xml, last change in rev 1.6 --> <!-- last change to 'natsort' in en/ tree in rev 1.25 --> -<!-- EN-Revision: 1.5 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.8 Maintainer: cucinato Status: ready --> <!-- OLD-Revision: 1.173/EN.1.25 --> <refentry id="function.natsort"> <refnamediv> @@ -29,7 +29,7 @@ <programlisting role="php"> <![CDATA[ <?php -$array1 = $array2 = array ("img12.png", "img10.png", "img2.png", "img1.png"); +$array1 = $array2 = array("img12.png", "img10.png", "img2.png", "img1.png"); sort($array1); echo "Ordinamento standard\n"; @@ -41,13 +41,10 @@ ?> ]]> </programlisting> - </example> - </para> - <para> - Questo codice genererà il seguente risultato: - </para> - <para> - <screen> + <para> + Questo codice genererà il seguente risultato: + </para> + <screen> <![CDATA[ Ordinamento standard Array @@ -67,11 +64,20 @@ [0] => img12.png ) ]]> - </screen> - Per ulteriori informazioni vedere la pagina di Martin Pool <ulink - url="&url.strnatcmp;">Natural Order String Comparison</ulink> - . + </screen> + <para> + Per ulteriori informazioni vedere la pagina di Martin Pool <ulink + url="&url.strnatcmp;">Natural Order String Comparison</ulink> + . + </para> + </example> </para> + <note> + <para> + Se si vogliono mantenere le associazione tra indici e valori, + utilizzare <literal>uasort($arr, 'strnatcmp')</literal>. + </para> + </note> <para> Vedere anche <function>natcasesort</function>, <function>strnatcmp</function> e Index: phpdoc-it/reference/array/functions/usort.xml diff -u phpdoc-it/reference/array/functions/usort.xml:1.7 phpdoc-it/reference/array/functions/usort.xml:1.8 --- phpdoc-it/reference/array/functions/usort.xml:1.7 Sun Feb 9 15:58:51 2003 +++ phpdoc-it/reference/array/functions/usort.xml Mon Nov 17 19:04:36 2003 @@ -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.8 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.13 Maintainer: cucinato Status: ready --> <!-- OLD-Revision: 1.173/EN.1.2 --> <refentry id="function.usort"> <refnamediv> @@ -28,12 +28,14 @@ o superiore a zero se il primo elemento è da considerarsi rispettivamente minore, uguale o maggiore del secondo. + </para> + <para> <note> <para> - Se due parametri vengono valutati come uguali, il loro ordinamento nell'array ordinato è indefinito. - Fino al PHP 4.0.6 le funzioni definite dall'utente mantenevano l'ordine originario per - questi elementi, ma con il nuovo algoritmo di ordinamento introdotto con la versione 4.1.0 questo - non succede più dal momento che non c'è un modo per ottenerlo in maniera efficiente. + Se due parametri vengono valutati come uguali, il loro ordinamento nell'array ordinato è indefinito. + Fino al PHP 4.0.6 le funzioni definite dall'utente mantenevano l'ordine originario per + questi elementi, ma con il nuovo algoritmo di ordinamento introdotto con la versione 4.1.0 questo + non succede più dal momento che non c'è un modo per ottenerlo in maniera efficiente. </para> </note> </para> @@ -42,39 +44,41 @@ <title>esempio di <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 ($chiave, $valore) = each ($a)) { +while (list($chiave, $valore) = each($a)) { echo "$chiave: $valore\n"; } +?> ]]> </programlisting> - </example> - </para> - <para> - Questo esempio mostrerà: - </para> - <para> - <screen> + <para> + Questo esempio mostrerà: + </para> + <screen> <![CDATA[ -0: 6 -1: 5 +0: 1 +1: 2 2: 3 -3: 2 -4: 1 +3: 5 +4: 6 ]]> - </screen> + </screen> + </example> </para> <note> <para> - Ovviamente, in questo caso banale di ordinamento decrescente la funzione <function>rsort</function> + Ovviamente, in questo caso banale di ordinamento decrescente la funzione <function>sort</function> sarebbe stata più appropriata. </para> </note> @@ -85,6 +89,7 @@ </title> <programlisting role="php"> <![CDATA[ +<?php function cmp ($a, $b) { return strcmp($a["frutto"], $b["frutto"]); } @@ -95,28 +100,27 @@ usort($frutti, "cmp"); -while (list ($chiave, $valore) = each ($frutti)) { +while (list($chiave, $valore) = each($frutti)) { echo "\$frutti[$chiave]: " . $valore["frutto"] . "\n"; } +?> ]]> </programlisting> - </example> - </para> - <para> - Quando si ordina un array multidimensionale, $a e $b contengono - riferimenti al primo indice dell'array. - </para> - <para> - Questo esempio mostrerà: - </para> - <para> - <screen> + <para> + Quando si ordina un array multidimensionale, $a e $b contengono + riferimenti al primo indice dell'array. + </para> + <para> + Questo esempio mostrerà: + </para> + <screen> <![CDATA[ $frutti[0]: arance $frutti[1]: limoni $frutti[2]: uva ]]> - </screen> + </screen> + </example> </para> <para> @@ -126,6 +130,7 @@ </title> <programlisting role="php"> <![CDATA[ +<? class OggettoTest { var $nome; @@ -139,7 +144,9 @@ { $al = strtolower($a->nome); $bl = strtolower($b->nome); - if ($al == $bl) return 0; + if ($al == $bl) { + return 0; + } return ($al > $bl) ? +1 : -1; } } @@ -148,26 +155,25 @@ $a[] = new OggettoTest("b"); $a[] = new OggettoTest("d"); -uasort($a, array ("OggettoTest", "comp_ogg")); +usort($a, array("OggettoTest", "comp_ogg")); foreach ($a as $voce) { print $voce->nome."\n"; } +?> ]]> </programlisting> - </example> - </para> - <para> - Questo esempio mostrerà: - </para> - <para> - <screen> + <para> + Questo esempio mostrerà: + </para> + <screen> <![CDATA[ b c d ]]> - </screen> + </screen> + </example> </para> <para>