cvs: phpdoc /it/functions array.xml bzip2.xml
| From: | Marco Cucinato | Date: | Wed, 09 Jan 2002 12:05:58 +0000 |
| Subject: | cvs: phpdoc /it/functions array.xml bzip2.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969340989@lists.php.net to get a copy of this message | ||
cucinato Wed Jan 9 07:05:58 2002 EDT
Modified files:
/phpdoc/it/functions array.xml bzip2.xml
Log:
Synced to EN version
Index: phpdoc/it/functions/array.xml diff -u phpdoc/it/functions/array.xml:1.39 phpdoc/it/functions/array.xml:1.40 --- phpdoc/it/functions/array.xml:1.39 Tue Jan 1 09:35:16 2002 +++ phpdoc/it/functions/array.xml Wed Jan 9 07:05:57 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> - <!-- EN-Revision: 1.147 Maintainer: cucinato Status: ready --> + <!-- EN-Revision: 1.150 Maintainer: cucinato Status: ready --> <reference id="ref.array"> <title>Funzioni di Array</title> <titleabbrev>Arrays</titleabbrev> @@ -15,14 +15,14 @@ Ci sono specifiche funzioni di database per riempire gli array a partire da interrogazioni sui dati, e parecchie funzioni restituiscono array. </simpara> - <para> + <para> Vedere la sezione <link linkend="language.types.array">Array</link> del manuale per una spiegazione dettagliata di come gli array siano implementati ed usati in PHP. </para> <para> - Vedere anche <function>is_array</function>, <function>explode</function>, - <function>implode</function>, <function>split</function> + Vedere anche <function>is_array</function>, <function>explode</function>, + <function>implode</function>, <function>split</function>, e <function>join</function>. </para> </partintro> @@ -39,7 +39,7 @@ <funcsynopsis> <funcprototype> <funcdef>array <function>array</function></funcdef> - <paramdef>mixed + <paramdef>mixed <parameter><optional>...</optional></parameter> </paramdef> </funcprototype> @@ -92,7 +92,7 @@ ]]> </programlisting> <para> - che stamperà: + che stamperà: <screen role="php"> <![CDATA[ Array @@ -104,7 +104,7 @@ [4] => 1 [8] => 1 [9] => 19 - ) +) ]]> </screen> </para> @@ -124,10 +124,10 @@ ]]> </programlisting> <para> - che stamperà: + che stamperà: <screen> <![CDATA[ -Array +Array ( [1] => 'Gennaio' [2] => 'Febbraio' @@ -139,8 +139,8 @@ </example> </para> <para> - Vedere anche: <function>array_pad</function>, - <function>list</function>, e <function>range</function> + Vedere anche <function>array_pad</function>, + <function>list</function> e <function>range</function> </para> </refsect1> </refentry> @@ -308,10 +308,23 @@ <programlisting role="php"> <![CDATA[ $array = array (1, "ciao", 1, "mondo", "ciao"); -array_count_values ($array); // restituisce l'array (1=>2, "ciao"=>2, "mondo"=>1) +print_r(array_count_values ($array)); ]]> </programlisting> - </example> + <para> + Il risultato di questo programma sarà: + <screen> +<![CDATA[ +Array +( + [1] => 2 + [ciao] => 2 + [mondo[ => 1 +) +]]> + </screen> + </para> + </example> </para> </refsect1> </refentry> @@ -350,7 +363,7 @@ ]]> </programlisting> </example> - </para> + </para> <para> In questo modo <varname>$risultato</varname> sarà <literal>array ("blue");</literal>. Occorrenze multiple in @@ -389,7 +402,7 @@ <funcprototype> <funcdef>array <function>array_filter</function></funcdef> <paramdef>array <parameter>input</parameter></paramdef> - <paramdef>mixed + <paramdef>mixed <parameter><optional>callback</optional></parameter> </paramdef> </funcprototype> @@ -411,27 +424,45 @@ } function pari($var) { - return ($var % 2 == 0); + return ($var % 2 == 0); } $array1 = array ("a"=>1, "b"=>2, "c"=>3, "d"=>4, "e"=>5); $array2 = array (6, 7, 8, 9, 10, 11, 12); -$arr_dispari = array_filter($array1, "dispari"); -$arr_pari = array_filter($array2, "pari"); +echo "Dispari :\n"; +print_r(array_filter($array1, "dispari"); +echo "Pari :\n"; +print_r(array_filter($array2, "pari"); ]]> </programlisting> + <para> + Il risultato di questo sarà: + <screen role="php"> +<![CDATA[ +Dispari : +Array +( + [a] => 1 + [c] => 3 + [e] => 5 +) +Pari: +Array +( + [0] => 6 + [2] => 8 + [4] => 10 + [6] => 12 +) +]]> + </screen> + </para> </example> - </para> - <para> - In questo modo <varname>$arr_dispari</varname> sarà - <literal>array ("a"=>1, "c"=>3, "e"=>5);</literal>, - e <varname>$arr_pari</varname> sarà - <literal>array (6, 8, 10, 12);</literal>, </para> ¬e.func-callback; <para> - Vedere anche <function>array_map</function>, e + Vedere anche <function>array_map</function> e <function>array_reduce</function>. </para> </refsect1> @@ -464,7 +495,7 @@ </para> <para> Se un valore ha più di una occorrenza, L'ultima chiave verrà - usata come valore, e tutte le altre verranno perse. + usata come valore, e tutte le altre verranno perse. </para> <para> <function>array_flip</function> restituisce &false; @@ -488,9 +519,21 @@ <![CDATA[ $trans = array ("a" => 1, "b" => 1, "c" => 2); $trans = array_flip ($trans); -// ora $trans è : array(1 => "b", 2 => "c"); +print_r($trans); ]]> </programlisting> + <para> + ora $trans è: + <screen> +<![CDATA[ +Array +( + [1] => b + [2] => c +) +]]> + </screen> + </para> </example> </para> </refsect1> @@ -523,19 +566,24 @@ <programlisting role="php"> <![CDATA[ $a = array_fill(5, 6, 'banana'); - -/* -$a ora ha i seguenti elementi: - -$a[5] = "banana"; -$a[6] = "banana"; -$a[7] = "banana"; -$a[8] = "banana"; -$a[9] = "banana"; -$a[10] = "banana"; -*/ ]]> </programlisting> + <para> + $a ora ha i seguenti elementi (usando la funzione <function>print_r<function>): + <screen> +<![CDATA[ +Array +( + [5] => banana + [6] => banana + [7] => banana + [8] => banana + [9] => banana + [10] => banana +) +]]> + </screen> + </para> </example> </para> </refsect1> @@ -574,11 +622,19 @@ $risultato = array_intersect ($array1, $array2); ]]> </programlisting> + <para> + In questo modo <<varname>$result</varname> sarà: + <screen role="php"> +<![CDATA[ +Array +( + [a] => verde + [0] => rosso +) +]]> + </screen> + </para> </example> - </para> - <para> - In questo modo <varname>$result</varname> sarà <literal>array ("a" - => "verde", "rosso");</literal> </para> <note> <simpara> @@ -678,15 +734,38 @@ <programlisting role="php"> <![CDATA[ $array = array (0 => 100, "colore" => "rosso"); -array_keys ($array); // restituisce array (0, "colore") +print_r(array_keys ($array)) $array = array ("blu", "rosso", "verde", "blu", "blu"); -array_keys ($array, "blu"); // restituisce array (0, 3, 4) +print_r(array_keys ($array, "blu")); $array = array ("colore" => array("blu", "rosso", "verde"), "misura" => array("piccola", "media", "grande")); -array_keys ($array); // restituisce array ("colore", "misura") +print_r(array_keys ($array)); ]]> </programlisting> + <para> + Il risultato di questo programma sarà: + <screen> +<![CDATA[ +Array +( + [0] => 0 + [1] => colore +) +Array +( + [0] => 0 + [1] => 3 + [2] => 4 +) +Array +( + [0] => colore + [1] => misura +) +]]> + </screen> + </para> </example> </para> <note> @@ -758,15 +837,27 @@ $a = array(1, 2, 3, 4, 5); $b = array_map("cubo", $a); +print_r($b); ]]> </programlisting> + <para> + In questo modo <varname>$b</varname> sarà: + <screen> +<![CDATA[ +Array +( + [0] => 1 + [1] => 8 + [2] => 27 + [3] => 64 + [4] => 125 +) +]]> + </screen> + </para> </example> </para> <para> - L'array <varname>$b</varname> conterrà - <literal>array (1, 8, 27, 64, 125);</literal> - </para> - <para> <example> <title><function>array_map</function> - usare più array</title> <programlisting role="php"> @@ -783,54 +874,58 @@ $b = array("uno", "dos", "tres", "cuatro", "cinco"); $c = array_map("mostra_Spagnolo", $a, $b); - print_r($c); -// darà: -// Array -// ( -// [0] => Il numero 1 si dice uno in Spagnolo -// [1] => Il numero 2 si dice dos in Spagnolo -// [2] => Il numero 3 si dice tres in Spagnolo -// [3] => Il numero 4 si dice cuatro in Spagnolo -// [4] => Il numero 5 si dice cinco in Spagnolo -// ) +$d = array_map("mappa_Spagnolo", $a, $b); +print_r($d); +]]> + </programlisting> + <para> + Questo restituisce: + <screen> +<![CDATA[ +//stampa di $c +Array +( + [0] => Il numero 1 si dice uno in Spagnolo + [1] => Il numero 2 si dice dos in Spagnolo + [2] => Il numero 3 si dice tres in Spagnolo + [3] => Il numero 4 si dice cuatro in Spagnolo + [4] => Il numero 5 si dice cinco in Spagnolo +) + +// stampa di $d +Array +( + [0] => Array + ( + [1] => uno + ) -$d = array_map("mappa_Spagnolo", $a , $b); + [1] => Array + ( + [2] => dos + ) -print_r($d); + [2] => Array + ( + [3] => tres + ) + + [3] => Array + ( + [4] => cuatro + ) -// darà: -// Array -// ( -// [0] => Array -// ( -// [1] => uno -// ) -// -// [1] => Array -// ( -// [2] => dos -// ) -// -// [2] => Array -// ( -// [3] => tres -// ) -// -// [3] => Array -// ( -// [4] => cuatro -// ) -// -// [4] => Array -// ( -// [5] => cinco -// ) -// -// ) + [4] => Array + ( + [5] => cinco + ) + +) ]]> - </programlisting> + </screen> + </para> </example> </para> <para> @@ -856,52 +951,57 @@ $d = array_map(null, $a, $b, $c); print_r($d); - -// darà: -// Array -// ( -// [0] => Array -// ( -// [0] => 1 -// [1] => uno -// [2] => uno -// ) -// -// [1] => Array -// ( -// [0] => 2 -// [1] => due -// [2] => dos -// ) -// -// [2] => Array -// ( -// [0] => 3 -// [1] => tre -// [2] => tres -// ) -// -// [3] => Array -// ( -// [0] => 4 -// [1] => quattro -// [2] => cuatro -// ) -// -// [4] => Array -// ( -// [0] => 5 -// [1] => cinque -// [2] => cinco -// ) -// -// ) ]]> </programlisting> </example> </para> <para> - Vedere anche <function>array_filter</function>, + Il risultato di questo programma sarà; + <screen> +<![CDATA[ +Array +( + [0] => Array + ( + [0] => 1 + [1] => uno + [2] => uno + ) + + [1] => Array + ( + [0] => 2 + [1] => due + [2] => dos + ) + + [2] => Array + ( + [0] => 3 + [1] => tre + [2] => tres + ) + + [3] => Array + ( + [0] => 4 + [1] => quattro + [2] => cuatro + ) + + [4] => Array + ( + [0] => 5 + [1] => cinque + [2] => cinco + ) + +) +]]> + </screen> + </para> + <para> + Vedere anche <function>array_filter</function> e <function>array_reduce</function>. </para> </refsect1> @@ -942,16 +1042,29 @@ <![CDATA[ $array1 = array ("colore" => "rosso", 2, 4); $array2 = array ("a", "b", "colore" => "verde", "forma" => "trapezio", 4); -$result = array_merge ($array1, $array2); +$risultato = array_merge ($array1, $array2); ]]> </programlisting> + <para> + La variabile <varname>$risultato</varname> sarà: + <screen role="php"> +<![CDATA[ +Array +( + [colore] => verde + [0] => 2 + [1] => 4 + [2] => a + [3] => b + [forma] => trapezio + [4] => 4 +) +]]> + </screen> + </para> </example> </para> <para> - L'array risultante sarà <literal>array("colore" => "verde", 2, 4, - "a", "b", "forma" => "trapezio", 4)</literal>. - </para> - <para> Vedere anche <function>array_merge_recursive</function>. </para> </refsect1> @@ -994,16 +1107,35 @@ <![CDATA[ $ar1 = array ("colore" => array ("preferito" => "rosso"), 5); $ar2 = array (10, "colore" => array ("preferito" => "verde", "blu")); -$result = array_merge_recursive ($ar1, $ar2); +$risultato = array_merge_recursive ($ar1, $ar2); ]]> </programlisting> + <para> + La variabile <varname>$risultato</varname> sarà: + <screen role="php"> +<![CDATA[ +Array +( + [colore] => Array + ( + [preferito] => Array + ( + [0] => rosso + [1] => verde + ) + + [0] => blu + ) + + [0] => 5 + [1] => 10 +) +]]> + </screen> + </para> </example> </para> <para> - L'array risultante sarà <literal>array ("colore" => array - ("preferito" => array ("rosso", "verde"), "blu"), 5, 10)</literal>. - </para> - <para> Vedere anche <function>array_merge</function>. </para> </refsect1> @@ -1108,7 +1240,7 @@ <programlisting role="php"> <![CDATA[ $ar = array (array ("10", 100, 100, "a"), array (1, 3, "2", 1)); -array_multisort ($ar[0], SORT_ASC, SORT_STRING, +array_multisort ($ar[0], SORT_ASC, SORT_STRING, $ar[1], SORT_NUMERIC, SORT_DESC); ]]> </programlisting> @@ -1189,8 +1321,8 @@ <para> <function>array_pop</function> estrae e restituisce l'ultimo valore di <parameter>array</parameter>, accorciando - <parameter>array</parameter> di un elemento. - Se <parameter>array</parameter> è vuoto (o non è un array), + <parameter>array</parameter> di un elemento. + Se <parameter>array</parameter> è vuoto (o non è un array), viene restituito &null;. </para> <para> @@ -1198,21 +1330,31 @@ <title>esempio di <function>array_pop</function></title> <programlisting role="php"> <![CDATA[ -$pila = array ("arancia", "mela", "lampone"); +$pila = array ("arancia", "banana", "mela", "lampone"); $frutto = array_pop ($pila); ]]> </programlisting> + <para> + Dopo questa istruzione, <varname>$pila</varname> avrà solo 3 elementi: + <screen role="php"> +<![CDATA[ +Array +( + [0] => arancia + [1] => banana + [2] => mela +) +]]> + </screen> + e <literal>lampone</literal> verràa assegnato alla variabile + <varname>$frutto</varname>. + </para> </example> </para> - <para> - Dopo questa operazione, <varname>$pila</varname> ha solo 2 elementi: - "arancia" e "mela", e <varname>$frutto</varname> contiene - "lampone". - </para> &return.falseproblem; <para> Vedere anche <function>array_push</function>, - <function>array_shift</function>, e + <function>array_shift</function> e <function>array_unshift</function>. </para> </refsect1> @@ -1258,19 +1400,30 @@ <title>esempio di <function>array_push</function></title> <programlisting role="php"> <![CDATA[ -$pila = array (1, 2); -array_push ($pila, "+", 3); +$pila = array ("arancia", "banana"); +array_push ($pila, "mela", "lampone"); ]]> </programlisting> + <para> + In questo esempio <varname>$pila</varname> avrà + i seguenti elementi: + <screen role="php"> +<![CDATA[ +Array +( + [0] => arancia + [1] => banana + [2] => mela + [3] => lampone +) +]]> + </screen> + </para> </example> </para> <para> - Questo esempio fa sì che <varname>$pila</varname> abbia 4 - elementi: 1, 2, "+", e 3. - </para> - <para> - Vedere anche: <function>array_pop</function>, - <function>array_shift</function>, e + Vedere anche <function>array_pop</function>, + <function>array_shift</function> e <function>array_unshift</function>. </para> </refsect1> @@ -1327,7 +1480,7 @@ </para> </refsect1> </refentry> - + <refentry id="function.array-reverse"> <refnamediv> <refname>array_reverse</refname> @@ -1362,15 +1515,42 @@ $resultato_chiavi = array_reverse ($input, TRUE); ]]> </programlisting> + <para> + Questo fa sì che sia <varname>$risultato</varname> che + <varname>$risultato_chiavi</varname> abbiano gli stessi elementi, ma + si noti la differenza tra le chiavi. La stampa di + <varname>$risultato</varname> e + <varname>$risultato_chiavi</varname> sarà: + <screen role="php"> +<![CDATA[ +Array +( + [0] => Array + ( + [0] => verde + [1] => rosso + ) + + [1] => 4 + [2] => php +) +Array +( + [2] => Array + ( + [0] => verde + [1] => rosso + ) + + [1] => 4 + [0] => php +) +]]> + </screen> + </para> + </example> </para> - <para> - In questo modo sia <varname>$result</varname> che - <varname>$result_keyed</varname> sono <literal>array(array - ("verde", "rosso"), 4.0, "php")</literal>. Ma - <varname>$risultato_chiavi[0]</varname> è sempre - <literal>"php"</literal>. - </para> <note> <para> Il secondo parametro è stato aggiunto in PHP 4.0.3. @@ -1438,7 +1618,7 @@ conterrà <literal>1</literal>. </para> <para> - Vedere anche <function>array_filter</function>, + Vedere anche <function>array_filter</function> e <function>array_map</function>. </para> </refsect1> @@ -1471,19 +1651,30 @@ <title>esempio di <function>array_shift</function></title> <programlisting role="php"> <![CDATA[ -$args = array ("-v", "-f"); -$opt = array_shift ($args); +$pila = array ("arancia", "banana", "mela", lampone"); +$frutto = array_shift ($pila); ]]> </programlisting> + <para> + In questo modo <varname>$frutto</varname> rimarrà con 3 elementi: + <screen role="php"> +<![CDATA[ +Array +( + [0] => banana + [1] => mela + [2] => lampone +) +]]> + </screen> + e <literal>arancia</literal> sarà assegnata a + <varname>$frutto</varname>. + </para> </example> </para> <para> - Il risultato sarà <varname>$args</varname> contenente un elemento - "-f", e <varname>$opt</varname> uguale a "-v". - </para> - <para> Vedere anche <function>array_unshift</function>, - <function>array_push</function>, e + <function>array_push</function> e <function>array_pop</function>. </para> </refsect1> @@ -1636,20 +1827,20 @@ <programlisting role="php"> <![CDATA[ $input = array ("rosso", "verde", "blu", "giallo"); -array_splice ($input, 2); +array_splice ($input, 2); // $input è ora array ("rosso", "verde") $input = array ("rosso", "verde", "blu", "giallo"); -array_splice ($input, 1, -1); +array_splice ($input, 1, -1); // $input è ora array ("rosso", "giallo") $input = array ("rosso", "verde", "blu", "giallo"); -array_splice ($input, 1, count($input), "arancio"); +array_splice ($input, 1, count($input), "arancio"); // $input è ora array ("rosso", "arancio") $input = array ("rosso", "verde", "blu", "giallo"); -array_splice ($input, -1, 1, array("nero", "marrone")); -// $input è ora array ("rosso", "verde", +array_splice ($input, -1, 1, array("nero", "marrone")); +// $input è ora array ("rosso", "verde", // "blu", "nero", "marrone") ]]> </programlisting> @@ -1660,7 +1851,7 @@ </para> </refsect1> </refentry> - + <refentry id="function.array-sum"> <refnamediv> <refname>array_sum</refname> @@ -1673,7 +1864,7 @@ <funcsynopsis> <funcprototype> <funcdef>mixed <function>array_sum</function></funcdef> - <paramdef>array <parameter>arr</parameter></paramdef> + <paramdef>array <parameter>array</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -1684,16 +1875,23 @@ <example> <title>esempi di <function>array_sum</function></title> <programlisting role="php"> -<![[CDATA[ -$a = array(2,4,6,8); +<![CDATA[ +$a = array(2, 4, 6, 8); echo "sum(a) = ".array_sum($a)."\n"; -// stampa: sum(a) = 20 $b = array("a"=>1.2,"b"=>2.3,"c"=>3.4); echo "sum(b) = ".array_sum($b)."\n"; -// stampa: sum(b) = 6.9 ]]> </programlisting> + <para> + Il risultato di questo programma sarà: + <screen role="php"> +<![CDATA[ +sum(a) = 20 +sum(b) = 6.9 +]]> + </screen> + </para> </example> </para> <note> @@ -1726,9 +1924,11 @@ senza i valori duplicati. </para> <para> - Si noti che le chiavi sono mantenute. <function>array_unique</function> - manterrà la prima chiave trovata per ogni valore, e ignorerà tutte - le chiavi successive. + Si noti che le chiavi sono mantenute. <function>array_unique</function> ordina + i valori trattandoli come stringhe, quindi mantiene la prima chiave trovata + per ogni valore, e ignorerà tutte le altre chiavi. Questo non significa + che la chiave del primo valore dell'<parameter>array</parameter> non + ancora ordinato verrà mantenuta. </para> <note> <simpara> @@ -1755,15 +1955,21 @@ $input = array ("a" => "verde", "rosso", "b" => "verde", "blu", "rosso"); $risultato = array_unique ($input); print_r($result); -// il risultato sarà -//Array -//( -// [a] => verde -// [0] => rosso -// [1] => blu -//) ]]> </programlisting> + <para> + Questo mostrerà: + <screen role="php"> +<![CDATA[ +Array +( + [b] => verde + [1] => blu + [2] => rosso +) +]]> + </screen> + </para> </example> </para> <para> @@ -1775,16 +1981,20 @@ $risultato = array_unique ($input); var_dump($risultato); -/* risultato: + </programlisting> + <para> + Il risultato di questo programma sarà (PHP 4.0.6): + <scree role="php"> +<![CDATA[ array(2) { - [0]=> - int(4) - [1]=> - string(1) "3" + [0]=> + int(4) + [2]=> + string(1) "3" } -*/ ]]> - </programlisting> + </screen> + </para> </example> </para> </refsect1> @@ -1826,19 +2036,30 @@ <title>esempio di <function>array_unshift</function></title> <programlisting role="php"> <![CDATA[ -$lista = array ("p1", "p3"); -array_unshift ($lista, "p4", "p5", "p6"); +$lista = array ("arancia", "banana"); +array_unshift ($lista, "mela", "lampone"); ]]> </programlisting> + <para> + In questo modo <varname>$lista</varname> conterrà i + seguenti elementi: + <screen role="php"> +<![CDATA[ +Array +( + [0] => mela + [1] => lampone + [2] => arancia + [3] => banana +) +]]> + </screen> + </para> </example> </para> <para> - <varname>$lista</varname> conterrà 5 - elementi: "p4", "p5", "p6", "p1", e "p3". - </para> - <para> Vedere anche <function>array_shift</function>, - <function>array_push</function>, e + <function>array_push</function> e <function>array_pop</function>. </para> </refsect1> @@ -1867,9 +2088,21 @@ <programlisting role="php"> <![CDATA[ $array = array ("taglia" => "XL", "colore" => "oro"); -array_values ($array); // restituisce l'array ("XL", "oro") +print_r(array_values ($array)); ]]> </programlisting> + <para> + Questo mostrerà: + <screen role="php"> +<![CDATA[ +Array +( + [0] => XL + [1] => oro +) +]]> + </screen> + </para> </example> </para> <note> @@ -1913,16 +2146,16 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>array_walk</function></funcdef> - <paramdef>array <parameter>arr</parameter></paramdef> + <paramdef>array <parameter>array</parameter></paramdef> <paramdef>string <parameter>funzione</parameter></paramdef> - <paramdef>mixed + <paramdef>mixed <parameter><optional>datiutente</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <simpara> Esegue la funzione definita dall'utente identificata da <parameter>funzione</parameter> - su ogni elemento di <parameter>arr</parameter>. + su ogni elemento di <parameter>array</parameter>. A <parameter>funzione</parameter> verrà passato il valore dell'elemento come primo parametro e la chiave come secondo parametro. Se <parameter>datiutente</parameter> è specificato, verrà passato come @@ -1980,14 +2213,32 @@ function stampa ($elemento2, $chiave) { echo "$chiave. $elemento2<br>\n"; } - +echo "Prima ...:\n"; array_walk ($frutta, 'stampa'); reset ($frutta); array_walk ($frutta, 'modifica', 'frutto'); +echo "... e dopo:\n"; reset ($frutta); array_walk ($frutta, 'stampa'); ]]> </programlisting> + <para> + Il risultato del programma sarà: + <screen role="php"> +<![CDATA[ +Prima ...: +d. limone +a. arancia +b. banana +c. mela +... and after: +d. frutto: limone +a. frutto: arancia +b. frutto: banana +c. frutto: mela +]]> + </screen> + </para> </example> </para> <simpara> @@ -2009,7 +2260,7 @@ <funcprototype> <funcdef>void <function>arsort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter><optional>sort_flags</optional></parameter> </paramdef> </funcprototype> @@ -2054,8 +2305,8 @@ vedere <function>sort</function>. </para> <para> - vedere anche: <function>asort</function>, <function>rsort</function>, - <function>ksort</function>, e <function>sort</function>. + vedere anche <function>asort</function>, <function>rsort</function>, + <function>ksort</function> e <function>sort</function>. </para> </refsect1> </refentry> @@ -2107,7 +2358,7 @@ </para> </example> <para> - I frutti sono ordinati in ordine alfabetico , e l'indice + I frutti sono ordinati in ordine alfabetico, e l'indice associato ad ogni elemento è stato mantenuto. </para> <para> @@ -2117,7 +2368,7 @@ </para> <para> Vedere anche <function>arsort</function>, <function>rsort</function>, - <function>ksort</function>, e <function>sort</function>. + <function>ksort</function> e <function>sort</function>. </para> </refsect1> </refentry> @@ -2173,9 +2424,17 @@ ]]> </programlisting> <para> - In questo modo, <varname>$risultato</varname> sarà <literal>array - ("evento" => "SMAU", "citta" => "Milano", - "provincia" => "MI")</literal>. + In questo modo, <varname>$risultato</varname> sarà: + <screen role="php"> +<![CDATA[ +Array +( + [event] => SMAU + [citta] => Milano + [provincia] => MI +) +]]> + </screen> </para> </example> </para> @@ -2225,11 +2484,11 @@ <example> <title>esempio di <function>count</function></title> <programlisting role="php"> - <!-- TODO: examples about count(null), count(false), count(object).. --> + <!-- TODO: examples about count(null), count(false), count(object).. --> <![CDATA[ -$a[0] = 1; -$a[1] = 3; -$a[2] = 5; +$a[0] = 1; +$a[1] = 3; +$a[2] = 5; $risultato = count ($a); //$risultato == 3 @@ -2244,13 +2503,13 @@ </para> <note> <para> - La funzione <function>sizeof</function> è un alias per - <function>count</function>. + 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 + Vedere anche <function>is_array</function>, + <function>isset</function> e <function>strlen</function>. </para> </refsect1> @@ -2281,11 +2540,11 @@ puntatore interno punta oltre la fine della lista di elementi, <function>current</function> restituisce &false;. <warning> - <para> + <para> Se l'array contiene elementi vuoti (0 o "", la stringa - vuota) la funzione restituirà &false; + vuota) la funzione restituirà &false; pure per questi elementi. Questo rende impossibile - stabilire se si è veramente alla fine della lista in un + stabilire se si è veramente alla fine della lista in un array di questo tipo usando <function>current</function>. Per attraversare in modo corretto un array che può contenere elementi vuoti, usare la funzione <function>each</function>. @@ -2293,15 +2552,15 @@ </warning> </para> <para> - Vedere anche: <function>end</function>, <function>next</function>, - <function>prev</function>, e <function>reset</function>. + Vedere anche <function>end</function>, <function>next</function>, + <function>prev</function> e <function>reset</function>. </para> </refsect1> </refentry> <refentry id="function.each"> <refnamediv> - <refname>each</refname> + <refname>each</refname> <refpurpose> Restituisce la successiva coppia chiave/valore di un array e incrementa il puntatore dell'array @@ -2371,7 +2630,7 @@ <para> <function>each</function> viene normalmente usata in congiunzione con <function>list</function> nell'attraversamento di un array; per esempio, - <varname>$HTTP_POST_VARS</varname>: + <varname>$HTTP_POST_VARS</varname>: <example> <title> Attraversamento di <varname>$HTTP_POST_VARS</varname> con @@ -2383,7 +2642,7 @@ reset ($HTTP_POST_VARS); while (list ($chiave, $valore) = each ($HTTP_POST_VARS)) { echo "$chiave => $valore<br>"; - } +} ]]> </programlisting> </example> @@ -2398,7 +2657,7 @@ <para> Vedere anche <function>key</function>, <function>list</function>, <function>current</function>, <function>reset</function>, - <function>next</function>, e <function>prev</function>. + <function>next</function> e <function>prev</function>. </para> </refsect1> </refentry> @@ -2423,9 +2682,9 @@ all'ultimo elemento, e restituisce l'elemento. </para> <para> - Vedere anche: <function>current</function>, + Vedere anche <function>current</function>, <function>each</function>, - <function>next</function>, e <function>reset</function>. + <function>next</function> e <function>reset</function>. </para> </refsect1> </refentry> @@ -2443,10 +2702,10 @@ <funcprototype> <funcdef>int <function>extract</function></funcdef> <paramdef>array <parameter>var_array</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter><optional>extract_type</optional></parameter> </paramdef> - <paramdef>string + <paramdef>string <parameter><optional>prefix</optional></parameter> </paramdef> </funcprototype> @@ -2588,7 +2847,7 @@ non produce risultati. </para> <para> - Vedere anche: <function>compact</function>. + Vedere anche <function>compact</function>. </para> </refsect1> </refentry> @@ -2605,14 +2864,14 @@ <funcdef>bool <function>in_array</function></funcdef> <paramdef>mixed <parameter>ago</parameter></paramdef> <paramdef>array <parameter>pagliaio</parameter></paramdef> - <paramdef>bool + <paramdef>bool <parameter><optional>strict</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> Cerca in <parameter>pagliaio</parameter> per trovare - <parameter>ago</parameter> e restituisce &true; + <parameter>ago</parameter> e restituisce &true; se viene trovato nell'array, &false; altrimenti. </para> <para> @@ -2633,14 +2892,23 @@ <programlisting role="php"> <![CDATA[ $os = array ("Mac", "NT", "Irix", "Linux"); -if (in_array ("Irix", $os)){ - print "trovato Irix"; +if (in_array ("Irix", $os)) { + print "Trovato Irix"; } -if (in_array ("mac", $os)) { # fallisce perché in_array() valuta le maiuscole/minuscole +if (in_array ("mac", $os)) { print "Trovato mac"; } ]]> </programlisting> + <para> + La seconda condizione fallisce perché <function>in_array</function> + tiene conto di maiuscole e minuscole, quindi il programma mostrerà: + <screen role="php"> +<![CDATA[ +Trovato Irix +]]> + </screen> + </para> </example> </para> <para> @@ -2656,12 +2924,16 @@ if (in_array(1.13, $a, TRUE)) echo "1.13 trovato con controllo strict\n" ?> - -// Questo ritornerà: - -1.13 trovato con controllo strict ]]> </programlisting> + <para> + Questo mostrerà: + <screen role="php"> +<![CDATA[ +1.13 trovato con controllo strict +]]> + </screen> + </para> </example> </para> <para> @@ -2679,7 +2951,7 @@ </refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + <title>Descrizione</title> <funcsynopsis> <funcprototype> <funcdef>mixed <function>array_search</function></funcdef> @@ -2766,25 +3038,23 @@ Questo esempio mostrerà: </para> <para> - <informalexample> - <programlisting> + <screen> <![CDATA[ d = limone c = mela b = banana a = arancio ]]> - </programlisting> - </informalexample> + </screen> </para> <para> Si può modificare il comportamento dell'ordinamento usando il parametro - opzionale <parameter>sort_flags</parameter>, per ulteriori dettagli + opzionale <parameter>sort_flags</parameter>, per ulteriori dettagli vedere <function>sort</function>. </para> <simpara> Vedere anche <function>asort</function>, <function>arsort</function>, - <function>ksort</function> <function>sort</function>, + <function>ksort</function>, <function>sort</function>, <function>natsort</function> e <function>rsort</function>. </simpara> </refsect1> @@ -2801,7 +3071,7 @@ <funcprototype> <funcdef>int <function>ksort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter><optional>sort_flags</optional></parameter> </paramdef> </funcprototype> @@ -2827,16 +3097,14 @@ Questo esempio mostrerà: </para> <para> - <informalexample> - <programlisting> + <screen> <![CDATA[ a = arancia b = banana c = mela d = limone ]]> - </programlisting> - </informalexample> + </screen> </para> <para> Si può modificare il comportamento dell'ordinamento usando il parametro @@ -2845,7 +3113,7 @@ </para> <simpara> Vedere anche <function>asort</function>, <function>arsort</function>, - <function>sort</function>, <function>natsort</function>, e + <function>sort</function>, <function>natsort</function> e <function>rsort</function>. </simpara> <note> @@ -2936,7 +3204,7 @@ <programlisting role="php"> <![CDATA[ $array1 = $array2 = array ("img12.png", "img10.png", "img2.png", "img1.png"); - + sort($array1); echo "Ordinamento standard\n"; print_r($array1); @@ -2952,8 +3220,7 @@ Questo codice genererà il seguente risultato: </para> <para> - <informalexample> - <programlisting> + <screen> <![CDATA[ Ordinamento standard Array @@ -2971,10 +3238,9 @@ [2] => img2.png [1] => img10.png [0] => img12.png - ) +) ]]> - </programlisting> - </informalexample> + </screen> Per ulteriori informazioni vedere la pagina di Martin Pool <ulink url="&url.strnatcmp;">Natural Order String Comparison</ulink> . @@ -3058,7 +3324,7 @@ <warning> <para> Se l'array contiene elementi vuoti, o elementi che hanno il valore - chiave uguale a 0 allora questa funzione restituisce &false; + chiave uguale a 0 allora questa funzione restituisce &false; anche per questi elementi. Per esplorare correttamente un array che può contenere elementi vuoti o con chiave uguale a 0 vedere la funzione <function>each</function>. @@ -3066,9 +3332,9 @@ </warning> </para> <para> - Vedere anche: + Vedere anche <function>current</function>, <function>end</function>, - <function>prev</function>, e <function>reset</function>. + <function>prev</function> e <function>reset</function>. </para> </refsect1> </refentry> @@ -3087,10 +3353,11 @@ </funcprototype> </funcsynopsis> <simpara> - Questo è un alias di <function>current</function>. + Questo è un <link linkend="aliases">alias</link> + di <function>current</function>. </simpara> <para> - Vedere anche: + Vedere anche <function>end</function>, <function>next</function>, <function>prev</function> e <function>reset</function>. </para> @@ -3129,8 +3396,8 @@ interno di una posizione, invece che incrementarlo. </para> <para> - Vedere anche: <function>current</function>, <function>end</function>, - <function>next</function>, e <function>reset</function>. + Vedere anche <function>current</function>, <function>end</function>, + <function>next</function> e <function>reset</function>. </para> </refsect1> </refentry> @@ -3225,7 +3492,7 @@ dell'array. </para> <para> - Vedere anche: <function>current</function>, + Vedere anche <function>current</function>, <function>each</function>, <function>next</function>, e <function>prev</function>. </para> @@ -3243,7 +3510,7 @@ <funcprototype> <funcdef>void <function>rsort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter><optional>sort_flags</optional></parameter> </paramdef> </funcprototype> @@ -3268,16 +3535,14 @@ Questo esempio mostrerà: </para> <para> - <informalexample> - <programlisting> + <screen> <![CDATA[ 0 = mela 1 = limone 2 = banana 3 = arancia ]]> - </programlisting> - </informalexample> + </screen> </para> <para> I frutti sono stati ordinati in ordine alfabetico decrescente. @@ -3288,9 +3553,9 @@ vedere <function>sort</function>. </para> <para> - Vedere anche: <function>arsort</function>, + Vedere anche <function>arsort</function>, <function>asort</function>, <function>ksort</function>, - <function>sort</function>, e <function>usort</function>. + <function>sort</function> e <function>usort</function>. </para> </refsect1> </refentry> @@ -3368,7 +3633,7 @@ <funcprototype> <funcdef>void <function>sort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter><optional>sort_flags</optional></parameter> </paramdef> </funcprototype> @@ -3388,7 +3653,7 @@ while (list ($chiave, $valore) = each ($frutti)) { echo "frutti[".$chiave."] = ".$valore."\n"; } - + ?> ]]> </programlisting> @@ -3398,16 +3663,14 @@ Questo esempio mostrerà: </para> <para> - <informalexample> - <programlisting> + <screen> <![CDATA[ frutti[0] = arancia frutti[1] = banana frutti[2] = limone frutti[3] = mela ]]> - </programlisting> - </informalexample> + </screen> </para> <para> I frutti sono stati ordinati in ordine alfabetico. @@ -3431,11 +3694,11 @@ </itemizedlist> </para> <para> - Vedere anche: <function>arsort</function>, + Vedere anche <function>arsort</function>, <function>asort</function>, <function>ksort</function>, <function>natsort</function>, <function>natcasesort</function>, <function>rsort</function>, <function>usort</function>, - <function>array_multisort</function>, e + <function>array_multisort</function> e <function>uksort</function>. </para> <note> @@ -3479,7 +3742,7 @@ </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>. @@ -3513,7 +3776,7 @@ <title>esempio di <function>uksort</function></title> <programlisting role="php"> <![CDATA[ -function cmp ($a, $b) { +function cmp ($a, $b) { if ($a == $b) return 0; return ($a > $b) ? -1 : 1; } @@ -3532,20 +3795,18 @@ Questo esempio mostrerà: </para> <para> - <informalexample> - <programlisting> + <screen> <![CDATA[ 20: venti 10: dieci 4: quattro 3: tre ]]> - </programlisting> - </informalexample> + </screen> </para> ¬e.func-callback; <para> - Vedere anche: <function>usort</function>, <function>uasort</function>, + Vedere anche <function>usort</function>, <function>uasort</function>, <function>sort</function>, <function>asort</function>, <function>arsort</function>, <function>ksort</function>, <function>natsort</function> e <function>rsort</function>. @@ -3576,22 +3837,18 @@ questa funzione. </para> <para> - La funzione di comparazione deve restituire un intero minore, uguale - o maggiore di zero a seconda che il primo argomento sia considerato - rispettivamente minore, uguale o maggiore del - secondo. Se due elementi risultano uguali, il loro ordine - nell'array ordinato è indefinito. - </para> - <para> - È anche possibile usare una funzione membro di un oggetto come - funzione di comparazione. Vedere l'esempio numer 3 pù sotto. + La funzione di comparazione deve restituire un intero minore, + uguale o superiore a zero se il primo elemento è da considerarsi + rispettivamente monire, uguale o maggiore del secondo. + Se due parametri vengono valutati uguale, il loro ordinamento + nell'array ordinato è indefinito.. </para> <para> <example> <title>esempio di <function>usort</function></title> <programlisting role="php"> <![CDATA[ -function cmp ($a, $b) { +function cmp ($a, $b) { if ($a == $b) return 0; return ($a > $b) ? -1 : 1; } @@ -3611,8 +3868,7 @@ Questo esempio mostrerà: </para> <para> - <informalexample> - <programlisting> + <screen> <![CDATA[ 0: 6 1: 5 @@ -3620,8 +3876,7 @@ 3: 2 4: 1 ]]> - </programlisting> - </informalexample> + </screen> </para> <note> <para> @@ -3638,13 +3893,13 @@ <![CDATA[ function cmp ($a, $b) { return strcmp($a["frutto"], $b["frutto"]); -} +} $frutti[0]["frutto"] = "limoni"; $frutti[1]["frutto"] = "arance"; $frutti[2]["frutto"] = "uva"; -usort($frutti, "cmp"); +usort($frutti, "cmp"); while (list ($chiave, $valore) = each ($frutti)) { echo "\$frutti[$chiave]: " . $valore["frutto"] . "\n"; @@ -3661,17 +3916,15 @@ Questo esempio mostrerà: </para> <para> - <informalexample> - <programlisting> + <screen> <![CDATA[ $frutti[0]: arance $frutti[1]: limoni $frutti[2]: uva ]]> - </programlisting> - </informalexample> + </screen> </para> - + ¬e.func-callback; <para> <example> <title> @@ -3714,13 +3967,11 @@ Questo esempio mostrerà: </para> <para> - <informalexample> - <programlisting> + <screen> b c d - </programlisting> - </informalexample> + </screen> </para> <warning> <para> @@ -3730,11 +3981,11 @@ </para> </warning> <para> - Vedere anche: <function>uasort</function>, + Vedere anche <function>uasort</function>, <function>uksort</function>, <function>sort</function>, <function>asort</function>, <function>arsort</function>,<function>ksort</function>, - <function>natsort</function>, e <function>rsort</function>. + <function>natsort</function> e <function>rsort</function>. </para> </refsect1> </refentry> Index: phpdoc/it/functions/bzip2.xml diff -u phpdoc/it/functions/bzip2.xml:1.8 phpdoc/it/functions/bzip2.xml:1.9 --- phpdoc/it/functions/bzip2.xml:1.8 Sun Dec 30 19:42:47 2001 +++ phpdoc/it/functions/bzip2.xml Wed Jan 9 07:05:57 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.14 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.15 Maintainer: cucinato Status: ready --> <reference id="ref.bzip2"> <title>Funzioni di compressione Bzip2</title> <titleabbrev>Bzip2</titleabbrev> @@ -310,7 +310,7 @@ <parameter>bz</parameter>. </para> <para> - Restituisce &true; in caso di successo, &false; altrimenti. + &return.success; </para> <para> Vedere anche <function>bzread</function> e <function>bzwrite</function>.
Index: phpdoc/it/functions/array.xml diff -u phpdoc/it/functions/array.xml:1.39 phpdoc/it/functions/array.xml:1.40 --- phpdoc/it/functions/array.xml:1.39 Tue Jan 1 09:35:16 2002 +++ phpdoc/it/functions/array.xml Wed Jan 9 07:05:57 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> - <!-- EN-Revision: 1.147 Maintainer: cucinato Status: ready --> + <!-- EN-Revision: 1.150 Maintainer: cucinato Status: ready --> <reference id="ref.array"> <title>Funzioni di Array</title> <titleabbrev>Arrays</titleabbrev> @@ -15,14 +15,14 @@ Ci sono specifiche funzioni di database per riempire gli array a partire da interrogazioni sui dati, e parecchie funzioni restituiscono array. </simpara> - <para> + <para> Vedere la sezione <link linkend="language.types.array">Array</link> del manuale per una spiegazione dettagliata di come gli array siano implementati ed usati in PHP. </para> <para> - Vedere anche <function>is_array</function>, <function>explode</function>, - <function>implode</function>, <function>split</function> + Vedere anche <function>is_array</function>, <function>explode</function>, + <function>implode</function>, <function>split</function>, e <function>join</function>. </para> </partintro> @@ -39,7 +39,7 @@ <funcsynopsis> <funcprototype> <funcdef>array <function>array</function></funcdef> - <paramdef>mixed + <paramdef>mixed <parameter><optional>...</optional></parameter> </paramdef> </funcprototype> @@ -92,7 +92,7 @@ ]]> </programlisting> <para> - che stamperà: + che stamperà: <screen role="php"> <![CDATA[ Array @@ -104,7 +104,7 @@ [4] => 1 [8] => 1 [9] => 19 - ) +) ]]> </screen> </para> @@ -124,10 +124,10 @@ ]]> </programlisting> <para> - che stamperà: + che stamperà: <screen> <![CDATA[ -Array +Array ( [1] => 'Gennaio' [2] => 'Febbraio' @@ -139,8 +139,8 @@ </example> </para> <para> - Vedere anche: <function>array_pad</function>, - <function>list</function>, e <function>range</function> + Vedere anche <function>array_pad</function>, + <function>list</function> e <function>range</function> </para> </refsect1> </refentry> @@ -308,10 +308,23 @@ <programlisting role="php"> <![CDATA[ $array = array (1, "ciao", 1, "mondo", "ciao"); -array_count_values ($array); // restituisce l'array (1=>2, "ciao"=>2, "mondo"=>1) +print_r(array_count_values ($array)); ]]> </programlisting> - </example> + <para> + Il risultato di questo programma sarà: + <screen> +<![CDATA[ +Array +( + [1] => 2 + [ciao] => 2 + [mondo[ => 1 +) +]]> + </screen> + </para> + </example> </para> </refsect1> </refentry> @@ -350,7 +363,7 @@ ]]> </programlisting> </example> - </para> + </para> <para> In questo modo <varname>$risultato</varname> sarà <literal>array ("blue");</literal>. Occorrenze multiple in @@ -389,7 +402,7 @@ <funcprototype> <funcdef>array <function>array_filter</function></funcdef> <paramdef>array <parameter>input</parameter></paramdef> - <paramdef>mixed + <paramdef>mixed <parameter><optional>callback</optional></parameter> </paramdef> </funcprototype> @@ -411,27 +424,45 @@ } function pari($var) { - return ($var % 2 == 0); + return ($var % 2 == 0); } $array1 = array ("a"=>1, "b"=>2, "c"=>3, "d"=>4, "e"=>5); $array2 = array (6, 7, 8, 9, 10, 11, 12); -$arr_dispari = array_filter($array1, "dispari"); -$arr_pari = array_filter($array2, "pari"); +echo "Dispari :\n"; +print_r(array_filter($array1, "dispari"); +echo "Pari :\n"; +print_r(array_filter($array2, "pari"); ]]> </programlisting> + <para> + Il risultato di questo sarà: + <screen role="php"> +<![CDATA[ +Dispari : +Array +( + [a] => 1 + [c] => 3 + [e] => 5 +) +Pari: +Array +( + [0] => 6 + [2] => 8 + [4] => 10 + [6] => 12 +) +]]> + </screen> + </para> </example> - </para> - <para> - In questo modo <varname>$arr_dispari</varname> sarà - <literal>array ("a"=>1, "c"=>3, "e"=>5);</literal>, - e <varname>$arr_pari</varname> sarà - <literal>array (6, 8, 10, 12);</literal>, </para> ¬e.func-callback; <para> - Vedere anche <function>array_map</function>, e + Vedere anche <function>array_map</function> e <function>array_reduce</function>. </para> </refsect1> @@ -464,7 +495,7 @@ </para> <para> Se un valore ha più di una occorrenza, L'ultima chiave verrà - usata come valore, e tutte le altre verranno perse. + usata come valore, e tutte le altre verranno perse. </para> <para> <function>array_flip</function> restituisce &false; @@ -488,9 +519,21 @@ <![CDATA[ $trans = array ("a" => 1, "b" => 1, "c" => 2); $trans = array_flip ($trans); -// ora $trans è : array(1 => "b", 2 => "c"); +print_r($trans); ]]> </programlisting> + <para> + ora $trans è: + <screen> +<![CDATA[ +Array +( + [1] => b + [2] => c +) +]]> + </screen> + </para> </example> </para> </refsect1> @@ -523,19 +566,24 @@ <programlisting role="php"> <![CDATA[ $a = array_fill(5, 6, 'banana'); - -/* -$a ora ha i seguenti elementi: - -$a[5] = "banana"; -$a[6] = "banana"; -$a[7] = "banana"; -$a[8] = "banana"; -$a[9] = "banana"; -$a[10] = "banana"; -*/ ]]> </programlisting> + <para> + $a ora ha i seguenti elementi (usando la funzione <function>print_r<function>): + <screen> +<![CDATA[ +Array +( + [5] => banana + [6] => banana + [7] => banana + [8] => banana + [9] => banana + [10] => banana +) +]]> + </screen> + </para> </example> </para> </refsect1> @@ -574,11 +622,19 @@ $risultato = array_intersect ($array1, $array2); ]]> </programlisting> + <para> + In questo modo <<varname>$result</varname> sarà: + <screen role="php"> +<![CDATA[ +Array +( + [a] => verde + [0] => rosso +) +]]> + </screen> + </para> </example> - </para> - <para> - In questo modo <varname>$result</varname> sarà <literal>array ("a" - => "verde", "rosso");</literal> </para> <note> <simpara> @@ -678,15 +734,38 @@ <programlisting role="php"> <![CDATA[ $array = array (0 => 100, "colore" => "rosso"); -array_keys ($array); // restituisce array (0, "colore") +print_r(array_keys ($array)) $array = array ("blu", "rosso", "verde", "blu", "blu"); -array_keys ($array, "blu"); // restituisce array (0, 3, 4) +print_r(array_keys ($array, "blu")); $array = array ("colore" => array("blu", "rosso", "verde"), "misura" => array("piccola", "media", "grande")); -array_keys ($array); // restituisce array ("colore", "misura") +print_r(array_keys ($array)); ]]> </programlisting> + <para> + Il risultato di questo programma sarà: + <screen> +<![CDATA[ +Array +( + [0] => 0 + [1] => colore +) +Array +( + [0] => 0 + [1] => 3 + [2] => 4 +) +Array +( + [0] => colore + [1] => misura +) +]]> + </screen> + </para> </example> </para> <note> @@ -758,15 +837,27 @@ $a = array(1, 2, 3, 4, 5); $b = array_map("cubo", $a); +print_r($b); ]]> </programlisting> + <para> + In questo modo <varname>$b</varname> sarà: + <screen> +<![CDATA[ +Array +( + [0] => 1 + [1] => 8 + [2] => 27 + [3] => 64 + [4] => 125 +) +]]> + </screen> + </para> </example> </para> <para> - L'array <varname>$b</varname> conterrà - <literal>array (1, 8, 27, 64, 125);</literal> - </para> - <para> <example> <title><function>array_map</function> - usare più array</title> <programlisting role="php"> @@ -783,54 +874,58 @@ $b = array("uno", "dos", "tres", "cuatro", "cinco"); $c = array_map("mostra_Spagnolo", $a, $b); - print_r($c); -// darà: -// Array -// ( -// [0] => Il numero 1 si dice uno in Spagnolo -// [1] => Il numero 2 si dice dos in Spagnolo -// [2] => Il numero 3 si dice tres in Spagnolo -// [3] => Il numero 4 si dice cuatro in Spagnolo -// [4] => Il numero 5 si dice cinco in Spagnolo -// ) +$d = array_map("mappa_Spagnolo", $a, $b); +print_r($d); +]]> + </programlisting> + <para> + Questo restituisce: + <screen> +<![CDATA[ +//stampa di $c +Array +( + [0] => Il numero 1 si dice uno in Spagnolo + [1] => Il numero 2 si dice dos in Spagnolo + [2] => Il numero 3 si dice tres in Spagnolo + [3] => Il numero 4 si dice cuatro in Spagnolo + [4] => Il numero 5 si dice cinco in Spagnolo +) + +// stampa di $d +Array +( + [0] => Array + ( + [1] => uno + ) -$d = array_map("mappa_Spagnolo", $a , $b); + [1] => Array + ( + [2] => dos + ) -print_r($d); + [2] => Array + ( + [3] => tres + ) + + [3] => Array + ( + [4] => cuatro + ) -// darà: -// Array -// ( -// [0] => Array -// ( -// [1] => uno -// ) -// -// [1] => Array -// ( -// [2] => dos -// ) -// -// [2] => Array -// ( -// [3] => tres -// ) -// -// [3] => Array -// ( -// [4] => cuatro -// ) -// -// [4] => Array -// ( -// [5] => cinco -// ) -// -// ) + [4] => Array + ( + [5] => cinco + ) + +) ]]> - </programlisting> + </screen> + </para> </example> </para> <para> @@ -856,52 +951,57 @@ $d = array_map(null, $a, $b, $c); print_r($d); - -// darà: -// Array -// ( -// [0] => Array -// ( -// [0] => 1 -// [1] => uno -// [2] => uno -// ) -// -// [1] => Array -// ( -// [0] => 2 -// [1] => due -// [2] => dos -// ) -// -// [2] => Array -// ( -// [0] => 3 -// [1] => tre -// [2] => tres -// ) -// -// [3] => Array -// ( -// [0] => 4 -// [1] => quattro -// [2] => cuatro -// ) -// -// [4] => Array -// ( -// [0] => 5 -// [1] => cinque -// [2] => cinco -// ) -// -// ) ]]> </programlisting> </example> </para> <para> - Vedere anche <function>array_filter</function>, + Il risultato di questo programma sarà; + <screen> +<![CDATA[ +Array +( + [0] => Array + ( + [0] => 1 + [1] => uno + [2] => uno + ) + + [1] => Array + ( + [0] => 2 + [1] => due + [2] => dos + ) + + [2] => Array + ( + [0] => 3 + [1] => tre + [2] => tres + ) + + [3] => Array + ( + [0] => 4 + [1] => quattro + [2] => cuatro + ) + + [4] => Array + ( + [0] => 5 + [1] => cinque + [2] => cinco + ) + +) +]]> + </screen> + </para> + <para> + Vedere anche <function>array_filter</function> e <function>array_reduce</function>. </para> </refsect1> @@ -942,16 +1042,29 @@ <![CDATA[ $array1 = array ("colore" => "rosso", 2, 4); $array2 = array ("a", "b", "colore" => "verde", "forma" => "trapezio", 4); -$result = array_merge ($array1, $array2); +$risultato = array_merge ($array1, $array2); ]]> </programlisting> + <para> + La variabile <varname>$risultato</varname> sarà: + <screen role="php"> +<![CDATA[ +Array +( + [colore] => verde + [0] => 2 + [1] => 4 + [2] => a + [3] => b + [forma] => trapezio + [4] => 4 +) +]]> + </screen> + </para> </example> </para> <para> - L'array risultante sarà <literal>array("colore" => "verde", 2, 4, - "a", "b", "forma" => "trapezio", 4)</literal>. - </para> - <para> Vedere anche <function>array_merge_recursive</function>. </para> </refsect1> @@ -994,16 +1107,35 @@ <![CDATA[ $ar1 = array ("colore" => array ("preferito" => "rosso"), 5); $ar2 = array (10, "colore" => array ("preferito" => "verde", "blu")); -$result = array_merge_recursive ($ar1, $ar2); +$risultato = array_merge_recursive ($ar1, $ar2); ]]> </programlisting> + <para> + La variabile <varname>$risultato</varname> sarà: + <screen role="php"> +<![CDATA[ +Array +( + [colore] => Array + ( + [preferito] => Array + ( + [0] => rosso + [1] => verde + ) + + [0] => blu + ) + + [0] => 5 + [1] => 10 +) +]]> + </screen> + </para> </example> </para> <para> - L'array risultante sarà <literal>array ("colore" => array - ("preferito" => array ("rosso", "verde"), "blu"), 5, 10)</literal>. - </para> - <para> Vedere anche <function>array_merge</function>. </para> </refsect1> @@ -1108,7 +1240,7 @@ <programlisting role="php"> <![CDATA[ $ar = array (array ("10", 100, 100, "a"), array (1, 3, "2", 1)); -array_multisort ($ar[0], SORT_ASC, SORT_STRING, +array_multisort ($ar[0], SORT_ASC, SORT_STRING, $ar[1], SORT_NUMERIC, SORT_DESC); ]]> </programlisting> @@ -1189,8 +1321,8 @@ <para> <function>array_pop</function> estrae e restituisce l'ultimo valore di <parameter>array</parameter>, accorciando - <parameter>array</parameter> di un elemento. - Se <parameter>array</parameter> è vuoto (o non è un array), + <parameter>array</parameter> di un elemento. + Se <parameter>array</parameter> è vuoto (o non è un array), viene restituito &null;. </para> <para> @@ -1198,21 +1330,31 @@ <title>esempio di <function>array_pop</function></title> <programlisting role="php"> <![CDATA[ -$pila = array ("arancia", "mela", "lampone"); +$pila = array ("arancia", "banana", "mela", "lampone"); $frutto = array_pop ($pila); ]]> </programlisting> + <para> + Dopo questa istruzione, <varname>$pila</varname> avrà solo 3 elementi: + <screen role="php"> +<![CDATA[ +Array +( + [0] => arancia + [1] => banana + [2] => mela +) +]]> + </screen> + e <literal>lampone</literal> verràa assegnato alla variabile + <varname>$frutto</varname>. + </para> </example> </para> - <para> - Dopo questa operazione, <varname>$pila</varname> ha solo 2 elementi: - "arancia" e "mela", e <varname>$frutto</varname> contiene - "lampone". - </para> &return.falseproblem; <para> Vedere anche <function>array_push</function>, - <function>array_shift</function>, e + <function>array_shift</function> e <function>array_unshift</function>. </para> </refsect1> @@ -1258,19 +1400,30 @@ <title>esempio di <function>array_push</function></title> <programlisting role="php"> <![CDATA[ -$pila = array (1, 2); -array_push ($pila, "+", 3); +$pila = array ("arancia", "banana"); +array_push ($pila, "mela", "lampone"); ]]> </programlisting> + <para> + In questo esempio <varname>$pila</varname> avrà + i seguenti elementi: + <screen role="php"> +<![CDATA[ +Array +( + [0] => arancia + [1] => banana + [2] => mela + [3] => lampone +) +]]> + </screen> + </para> </example> </para> <para> - Questo esempio fa sì che <varname>$pila</varname> abbia 4 - elementi: 1, 2, "+", e 3. - </para> - <para> - Vedere anche: <function>array_pop</function>, - <function>array_shift</function>, e + Vedere anche <function>array_pop</function>, + <function>array_shift</function> e <function>array_unshift</function>. </para> </refsect1> @@ -1327,7 +1480,7 @@ </para> </refsect1> </refentry> - + <refentry id="function.array-reverse"> <refnamediv> <refname>array_reverse</refname> @@ -1362,15 +1515,42 @@ $resultato_chiavi = array_reverse ($input, TRUE); ]]> </programlisting> + <para> + Questo fa sì che sia <varname>$risultato</varname> che + <varname>$risultato_chiavi</varname> abbiano gli stessi elementi, ma + si noti la differenza tra le chiavi. La stampa di + <varname>$risultato</varname> e + <varname>$risultato_chiavi</varname> sarà: + <screen role="php"> +<![CDATA[ +Array +( + [0] => Array + ( + [0] => verde + [1] => rosso + ) + + [1] => 4 + [2] => php +) +Array +( + [2] => Array + ( + [0] => verde + [1] => rosso + ) + + [1] => 4 + [0] => php +) +]]> + </screen> + </para> + </example> </para> - <para> - In questo modo sia <varname>$result</varname> che - <varname>$result_keyed</varname> sono <literal>array(array - ("verde", "rosso"), 4.0, "php")</literal>. Ma - <varname>$risultato_chiavi[0]</varname> è sempre - <literal>"php"</literal>. - </para> <note> <para> Il secondo parametro è stato aggiunto in PHP 4.0.3. @@ -1438,7 +1618,7 @@ conterrà <literal>1</literal>. </para> <para> - Vedere anche <function>array_filter</function>, + Vedere anche <function>array_filter</function> e <function>array_map</function>. </para> </refsect1> @@ -1471,19 +1651,30 @@ <title>esempio di <function>array_shift</function></title> <programlisting role="php"> <![CDATA[ -$args = array ("-v", "-f"); -$opt = array_shift ($args); +$pila = array ("arancia", "banana", "mela", lampone"); +$frutto = array_shift ($pila); ]]> </programlisting> + <para> + In questo modo <varname>$frutto</varname> rimarrà con 3 elementi: + <screen role="php"> +<![CDATA[ +Array +( + [0] => banana + [1] => mela + [2] => lampone +) +]]> + </screen> + e <literal>arancia</literal> sarà assegnata a + <varname>$frutto</varname>. + </para> </example> </para> <para> - Il risultato sarà <varname>$args</varname> contenente un elemento - "-f", e <varname>$opt</varname> uguale a "-v". - </para> - <para> Vedere anche <function>array_unshift</function>, - <function>array_push</function>, e + <function>array_push</function> e <function>array_pop</function>. </para> </refsect1> @@ -1636,20 +1827,20 @@ <programlisting role="php"> <![CDATA[ $input = array ("rosso", "verde", "blu", "giallo"); -array_splice ($input, 2); +array_splice ($input, 2); // $input è ora array ("rosso", "verde") $input = array ("rosso", "verde", "blu", "giallo"); -array_splice ($input, 1, -1); +array_splice ($input, 1, -1); // $input è ora array ("rosso", "giallo") $input = array ("rosso", "verde", "blu", "giallo"); -array_splice ($input, 1, count($input), "arancio"); +array_splice ($input, 1, count($input), "arancio"); // $input è ora array ("rosso", "arancio") $input = array ("rosso", "verde", "blu", "giallo"); -array_splice ($input, -1, 1, array("nero", "marrone")); -// $input è ora array ("rosso", "verde", +array_splice ($input, -1, 1, array("nero", "marrone")); +// $input è ora array ("rosso", "verde", // "blu", "nero", "marrone") ]]> </programlisting> @@ -1660,7 +1851,7 @@ </para> </refsect1> </refentry> - + <refentry id="function.array-sum"> <refnamediv> <refname>array_sum</refname> @@ -1673,7 +1864,7 @@ <funcsynopsis> <funcprototype> <funcdef>mixed <function>array_sum</function></funcdef> - <paramdef>array <parameter>arr</parameter></paramdef> + <paramdef>array <parameter>array</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -1684,16 +1875,23 @@ <example> <title>esempi di <function>array_sum</function></title> <programlisting role="php"> -<![[CDATA[ -$a = array(2,4,6,8); +<![CDATA[ +$a = array(2, 4, 6, 8); echo "sum(a) = ".array_sum($a)."\n"; -// stampa: sum(a) = 20 $b = array("a"=>1.2,"b"=>2.3,"c"=>3.4); echo "sum(b) = ".array_sum($b)."\n"; -// stampa: sum(b) = 6.9 ]]> </programlisting> + <para> + Il risultato di questo programma sarà: + <screen role="php"> +<![CDATA[ +sum(a) = 20 +sum(b) = 6.9 +]]> + </screen> + </para> </example> </para> <note> @@ -1726,9 +1924,11 @@ senza i valori duplicati. </para> <para> - Si noti che le chiavi sono mantenute. <function>array_unique</function> - manterrà la prima chiave trovata per ogni valore, e ignorerà tutte - le chiavi successive. + Si noti che le chiavi sono mantenute. <function>array_unique</function> ordina + i valori trattandoli come stringhe, quindi mantiene la prima chiave trovata + per ogni valore, e ignorerà tutte le altre chiavi. Questo non significa + che la chiave del primo valore dell'<parameter>array</parameter> non + ancora ordinato verrà mantenuta. </para> <note> <simpara> @@ -1755,15 +1955,21 @@ $input = array ("a" => "verde", "rosso", "b" => "verde", "blu", "rosso"); $risultato = array_unique ($input); print_r($result); -// il risultato sarà -//Array -//( -// [a] => verde -// [0] => rosso -// [1] => blu -//) ]]> </programlisting> + <para> + Questo mostrerà: + <screen role="php"> +<![CDATA[ +Array +( + [b] => verde + [1] => blu + [2] => rosso +) +]]> + </screen> + </para> </example> </para> <para> @@ -1775,16 +1981,20 @@ $risultato = array_unique ($input); var_dump($risultato); -/* risultato: + </programlisting> + <para> + Il risultato di questo programma sarà (PHP 4.0.6): + <scree role="php"> +<![CDATA[ array(2) { - [0]=> - int(4) - [1]=> - string(1) "3" + [0]=> + int(4) + [2]=> + string(1) "3" } -*/ ]]> - </programlisting> + </screen> + </para> </example> </para> </refsect1> @@ -1826,19 +2036,30 @@ <title>esempio di <function>array_unshift</function></title> <programlisting role="php"> <![CDATA[ -$lista = array ("p1", "p3"); -array_unshift ($lista, "p4", "p5", "p6"); +$lista = array ("arancia", "banana"); +array_unshift ($lista, "mela", "lampone"); ]]> </programlisting> + <para> + In questo modo <varname>$lista</varname> conterrà i + seguenti elementi: + <screen role="php"> +<![CDATA[ +Array +( + [0] => mela + [1] => lampone + [2] => arancia + [3] => banana +) +]]> + </screen> + </para> </example> </para> <para> - <varname>$lista</varname> conterrà 5 - elementi: "p4", "p5", "p6", "p1", e "p3". - </para> - <para> Vedere anche <function>array_shift</function>, - <function>array_push</function>, e + <function>array_push</function> e <function>array_pop</function>. </para> </refsect1> @@ -1867,9 +2088,21 @@ <programlisting role="php"> <![CDATA[ $array = array ("taglia" => "XL", "colore" => "oro"); -array_values ($array); // restituisce l'array ("XL", "oro") +print_r(array_values ($array)); ]]> </programlisting> + <para> + Questo mostrerà: + <screen role="php"> +<![CDATA[ +Array +( + [0] => XL + [1] => oro +) +]]> + </screen> + </para> </example> </para> <note> @@ -1913,16 +2146,16 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>array_walk</function></funcdef> - <paramdef>array <parameter>arr</parameter></paramdef> + <paramdef>array <parameter>array</parameter></paramdef> <paramdef>string <parameter>funzione</parameter></paramdef> - <paramdef>mixed + <paramdef>mixed <parameter><optional>datiutente</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <simpara> Esegue la funzione definita dall'utente identificata da <parameter>funzione</parameter> - su ogni elemento di <parameter>arr</parameter>. + su ogni elemento di <parameter>array</parameter>. A <parameter>funzione</parameter> verrà passato il valore dell'elemento come primo parametro e la chiave come secondo parametro. Se <parameter>datiutente</parameter> è specificato, verrà passato come @@ -1980,14 +2213,32 @@ function stampa ($elemento2, $chiave) { echo "$chiave. $elemento2<br>\n"; } - +echo "Prima ...:\n"; array_walk ($frutta, 'stampa'); reset ($frutta); array_walk ($frutta, 'modifica', 'frutto'); +echo "... e dopo:\n"; reset ($frutta); array_walk ($frutta, 'stampa'); ]]> </programlisting> + <para> + Il risultato del programma sarà: + <screen role="php"> +<![CDATA[ +Prima ...: +d. limone +a. arancia +b. banana +c. mela +... and after: +d. frutto: limone +a. frutto: arancia +b. frutto: banana +c. frutto: mela +]]> + </screen> + </para> </example> </para> <simpara> @@ -2009,7 +2260,7 @@ <funcprototype> <funcdef>void <function>arsort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter><optional>sort_flags</optional></parameter> </paramdef> </funcprototype> @@ -2054,8 +2305,8 @@ vedere <function>sort</function>. </para> <para> - vedere anche: <function>asort</function>, <function>rsort</function>, - <function>ksort</function>, e <function>sort</function>. + vedere anche <function>asort</function>, <function>rsort</function>, + <function>ksort</function> e <function>sort</function>. </para> </refsect1> </refentry> @@ -2107,7 +2358,7 @@ </para> </example> <para> - I frutti sono ordinati in ordine alfabetico , e l'indice + I frutti sono ordinati in ordine alfabetico, e l'indice associato ad ogni elemento è stato mantenuto. </para> <para> @@ -2117,7 +2368,7 @@ </para> <para> Vedere anche <function>arsort</function>, <function>rsort</function>, - <function>ksort</function>, e <function>sort</function>. + <function>ksort</function> e <function>sort</function>. </para> </refsect1> </refentry> @@ -2173,9 +2424,17 @@ ]]> </programlisting> <para> - In questo modo, <varname>$risultato</varname> sarà <literal>array - ("evento" => "SMAU", "citta" => "Milano", - "provincia" => "MI")</literal>. + In questo modo, <varname>$risultato</varname> sarà: + <screen role="php"> +<![CDATA[ +Array +( + [event] => SMAU + [citta] => Milano + [provincia] => MI +) +]]> + </screen> </para> </example> </para> @@ -2225,11 +2484,11 @@ <example> <title>esempio di <function>count</function></title> <programlisting role="php"> - <!-- TODO: examples about count(null), count(false), count(object).. --> + <!-- TODO: examples about count(null), count(false), count(object).. --> <![CDATA[ -$a[0] = 1; -$a[1] = 3; -$a[2] = 5; +$a[0] = 1; +$a[1] = 3; +$a[2] = 5; $risultato = count ($a); //$risultato == 3 @@ -2244,13 +2503,13 @@ </para> <note> <para> - La funzione <function>sizeof</function> è un alias per - <function>count</function>. + 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 + Vedere anche <function>is_array</function>, + <function>isset</function> e <function>strlen</function>. </para> </refsect1> @@ -2281,11 +2540,11 @@ puntatore interno punta oltre la fine della lista di elementi, <function>current</function> restituisce &false;. <warning> - <para> + <para> Se l'array contiene elementi vuoti (0 o "", la stringa - vuota) la funzione restituirà &false; + vuota) la funzione restituirà &false; pure per questi elementi. Questo rende impossibile - stabilire se si è veramente alla fine della lista in un + stabilire se si è veramente alla fine della lista in un array di questo tipo usando <function>current</function>. Per attraversare in modo corretto un array che può contenere elementi vuoti, usare la funzione <function>each</function>. @@ -2293,15 +2552,15 @@ </warning> </para> <para> - Vedere anche: <function>end</function>, <function>next</function>, - <function>prev</function>, e <function>reset</function>. + Vedere anche <function>end</function>, <function>next</function>, + <function>prev</function> e <function>reset</function>. </para> </refsect1> </refentry> <refentry id="function.each"> <refnamediv> - <refname>each</refname> + <refname>each</refname> <refpurpose> Restituisce la successiva coppia chiave/valore di un array e incrementa il puntatore dell'array @@ -2371,7 +2630,7 @@ <para> <function>each</function> viene normalmente usata in congiunzione con <function>list</function> nell'attraversamento di un array; per esempio, - <varname>$HTTP_POST_VARS</varname>: + <varname>$HTTP_POST_VARS</varname>: <example> <title> Attraversamento di <varname>$HTTP_POST_VARS</varname> con @@ -2383,7 +2642,7 @@ reset ($HTTP_POST_VARS); while (list ($chiave, $valore) = each ($HTTP_POST_VARS)) { echo "$chiave => $valore<br>"; - } +} ]]> </programlisting> </example> @@ -2398,7 +2657,7 @@ <para> Vedere anche <function>key</function>, <function>list</function>, <function>current</function>, <function>reset</function>, - <function>next</function>, e <function>prev</function>. + <function>next</function> e <function>prev</function>. </para> </refsect1> </refentry> @@ -2423,9 +2682,9 @@ all'ultimo elemento, e restituisce l'elemento. </para> <para> - Vedere anche: <function>current</function>, + Vedere anche <function>current</function>, <function>each</function>, - <function>next</function>, e <function>reset</function>. + <function>next</function> e <function>reset</function>. </para> </refsect1> </refentry> @@ -2443,10 +2702,10 @@ <funcprototype> <funcdef>int <function>extract</function></funcdef> <paramdef>array <parameter>var_array</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter><optional>extract_type</optional></parameter> </paramdef> - <paramdef>string + <paramdef>string <parameter><optional>prefix</optional></parameter> </paramdef> </funcprototype> @@ -2588,7 +2847,7 @@ non produce risultati. </para> <para> - Vedere anche: <function>compact</function>. + Vedere anche <function>compact</function>. </para> </refsect1> </refentry> @@ -2605,14 +2864,14 @@ <funcdef>bool <function>in_array</function></funcdef> <paramdef>mixed <parameter>ago</parameter></paramdef> <paramdef>array <parameter>pagliaio</parameter></paramdef> - <paramdef>bool + <paramdef>bool <parameter><optional>strict</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> Cerca in <parameter>pagliaio</parameter> per trovare - <parameter>ago</parameter> e restituisce &true; + <parameter>ago</parameter> e restituisce &true; se viene trovato nell'array, &false; altrimenti. </para> <para> @@ -2633,14 +2892,23 @@ <programlisting role="php"> <![CDATA[ $os = array ("Mac", "NT", "Irix", "Linux"); -if (in_array ("Irix", $os)){ - print "trovato Irix"; +if (in_array ("Irix", $os)) { + print "Trovato Irix"; } -if (in_array ("mac", $os)) { # fallisce perché in_array() valuta le maiuscole/minuscole +if (in_array ("mac", $os)) { print "Trovato mac"; } ]]> </programlisting> + <para> + La seconda condizione fallisce perché <function>in_array</function> + tiene conto di maiuscole e minuscole, quindi il programma mostrerà: + <screen role="php"> +<![CDATA[ +Trovato Irix +]]> + </screen> + </para> </example> </para> <para> @@ -2656,12 +2924,16 @@ if (in_array(1.13, $a, TRUE)) echo "1.13 trovato con controllo strict\n" ?> - -// Questo ritornerà: - -1.13 trovato con controllo strict ]]> </programlisting> + <para> + Questo mostrerà: + <screen role="php"> +<![CDATA[ +1.13 trovato con controllo strict +]]> + </screen> + </para> </example> </para> <para> @@ -2679,7 +2951,7 @@ </refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + <title>Descrizione</title> <funcsynopsis> <funcprototype> <funcdef>mixed <function>array_search</function></funcdef> @@ -2766,25 +3038,23 @@ Questo esempio mostrerà: </para> <para> - <informalexample> - <programlisting> + <screen> <![CDATA[ d = limone c = mela b = banana a = arancio ]]> - </programlisting> - </informalexample> + </screen> </para> <para> Si può modificare il comportamento dell'ordinamento usando il parametro - opzionale <parameter>sort_flags</parameter>, per ulteriori dettagli + opzionale <parameter>sort_flags</parameter>, per ulteriori dettagli vedere <function>sort</function>. </para> <simpara> Vedere anche <function>asort</function>, <function>arsort</function>, - <function>ksort</function> <function>sort</function>, + <function>ksort</function>, <function>sort</function>, <function>natsort</function> e <function>rsort</function>. </simpara> </refsect1> @@ -2801,7 +3071,7 @@ <funcprototype> <funcdef>int <function>ksort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter><optional>sort_flags</optional></parameter> </paramdef> </funcprototype> @@ -2827,16 +3097,14 @@ Questo esempio mostrerà: </para> <para> - <informalexample> - <programlisting> + <screen> <![CDATA[ a = arancia b = banana c = mela d = limone ]]> - </programlisting> - </informalexample> + </screen> </para> <para> Si può modificare il comportamento dell'ordinamento usando il parametro @@ -2845,7 +3113,7 @@ </para> <simpara> Vedere anche <function>asort</function>, <function>arsort</function>, - <function>sort</function>, <function>natsort</function>, e + <function>sort</function>, <function>natsort</function> e <function>rsort</function>. </simpara> <note> @@ -2936,7 +3204,7 @@ <programlisting role="php"> <![CDATA[ $array1 = $array2 = array ("img12.png", "img10.png", "img2.png", "img1.png"); - + sort($array1); echo "Ordinamento standard\n"; print_r($array1); @@ -2952,8 +3220,7 @@ Questo codice genererà il seguente risultato: </para> <para> - <informalexample> - <programlisting> + <screen> <![CDATA[ Ordinamento standard Array @@ -2971,10 +3238,9 @@ [2] => img2.png [1] => img10.png [0] => img12.png - ) +) ]]> - </programlisting> - </informalexample> + </screen> Per ulteriori informazioni vedere la pagina di Martin Pool <ulink url="&url.strnatcmp;">Natural Order String Comparison</ulink> . @@ -3058,7 +3324,7 @@ <warning> <para> Se l'array contiene elementi vuoti, o elementi che hanno il valore - chiave uguale a 0 allora questa funzione restituisce &false; + chiave uguale a 0 allora questa funzione restituisce &false; anche per questi elementi. Per esplorare correttamente un array che può contenere elementi vuoti o con chiave uguale a 0 vedere la funzione <function>each</function>. @@ -3066,9 +3332,9 @@ </warning> </para> <para> - Vedere anche: + Vedere anche <function>current</function>, <function>end</function>, - <function>prev</function>, e <function>reset</function>. + <function>prev</function> e <function>reset</function>. </para> </refsect1> </refentry> @@ -3087,10 +3353,11 @@ </funcprototype> </funcsynopsis> <simpara> - Questo è un alias di <function>current</function>. + Questo è un <link linkend="aliases">alias</link> + di <function>current</function>. </simpara> <para> - Vedere anche: + Vedere anche <function>end</function>, <function>next</function>, <function>prev</function> e <function>reset</function>. </para> @@ -3129,8 +3396,8 @@ interno di una posizione, invece che incrementarlo. </para> <para> - Vedere anche: <function>current</function>, <function>end</function>, - <function>next</function>, e <function>reset</function>. + Vedere anche <function>current</function>, <function>end</function>, + <function>next</function> e <function>reset</function>. </para> </refsect1> </refentry> @@ -3225,7 +3492,7 @@ dell'array. </para> <para> - Vedere anche: <function>current</function>, + Vedere anche <function>current</function>, <function>each</function>, <function>next</function>, e <function>prev</function>. </para> @@ -3243,7 +3510,7 @@ <funcprototype> <funcdef>void <function>rsort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter><optional>sort_flags</optional></parameter> </paramdef> </funcprototype> @@ -3268,16 +3535,14 @@ Questo esempio mostrerà: </para> <para> - <informalexample> - <programlisting> + <screen> <![CDATA[ 0 = mela 1 = limone 2 = banana 3 = arancia ]]> - </programlisting> - </informalexample> + </screen> </para> <para> I frutti sono stati ordinati in ordine alfabetico decrescente. @@ -3288,9 +3553,9 @@ vedere <function>sort</function>. </para> <para> - Vedere anche: <function>arsort</function>, + Vedere anche <function>arsort</function>, <function>asort</function>, <function>ksort</function>, - <function>sort</function>, e <function>usort</function>. + <function>sort</function> e <function>usort</function>. </para> </refsect1> </refentry> @@ -3368,7 +3633,7 @@ <funcprototype> <funcdef>void <function>sort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter><optional>sort_flags</optional></parameter> </paramdef> </funcprototype> @@ -3388,7 +3653,7 @@ while (list ($chiave, $valore) = each ($frutti)) { echo "frutti[".$chiave."] = ".$valore."\n"; } - + ?> ]]> </programlisting> @@ -3398,16 +3663,14 @@ Questo esempio mostrerà: </para> <para> - <informalexample> - <programlisting> + <screen> <![CDATA[ frutti[0] = arancia frutti[1] = banana frutti[2] = limone frutti[3] = mela ]]> - </programlisting> - </informalexample> + </screen> </para> <para> I frutti sono stati ordinati in ordine alfabetico. @@ -3431,11 +3694,11 @@ </itemizedlist> </para> <para> - Vedere anche: <function>arsort</function>, + Vedere anche <function>arsort</function>, <function>asort</function>, <function>ksort</function>, <function>natsort</function>, <function>natcasesort</function>, <function>rsort</function>, <function>usort</function>, - <function>array_multisort</function>, e + <function>array_multisort</function> e <function>uksort</function>. </para> <note> @@ -3479,7 +3742,7 @@ </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>. @@ -3513,7 +3776,7 @@ <title>esempio di <function>uksort</function></title> <programlisting role="php"> <![CDATA[ -function cmp ($a, $b) { +function cmp ($a, $b) { if ($a == $b) return 0; return ($a > $b) ? -1 : 1; } @@ -3532,20 +3795,18 @@ Questo esempio mostrerà: </para> <para> - <informalexample> - <programlisting> + <screen> <![CDATA[ 20: venti 10: dieci 4: quattro 3: tre ]]> - </programlisting> - </informalexample> + </screen> </para> ¬e.func-callback; <para> - Vedere anche: <function>usort</function>, <function>uasort</function>, + Vedere anche <function>usort</function>, <function>uasort</function>, <function>sort</function>, <function>asort</function>, <function>arsort</function>, <function>ksort</function>, <function>natsort</function> e <function>rsort</function>. @@ -3576,22 +3837,18 @@ questa funzione. </para> <para> - La funzione di comparazione deve restituire un intero minore, uguale - o maggiore di zero a seconda che il primo argomento sia considerato - rispettivamente minore, uguale o maggiore del - secondo. Se due elementi risultano uguali, il loro ordine - nell'array ordinato è indefinito. - </para> - <para> - È anche possibile usare una funzione membro di un oggetto come - funzione di comparazione. Vedere l'esempio numer 3 pù sotto. + La funzione di comparazione deve restituire un intero minore, + uguale o superiore a zero se il primo elemento è da considerarsi + rispettivamente monire, uguale o maggiore del secondo. + Se due parametri vengono valutati uguale, il loro ordinamento + nell'array ordinato è indefinito.. </para> <para> <example> <title>esempio di <function>usort</function></title> <programlisting role="php"> <![CDATA[ -function cmp ($a, $b) { +function cmp ($a, $b) { if ($a == $b) return 0; return ($a > $b) ? -1 : 1; } @@ -3611,8 +3868,7 @@ Questo esempio mostrerà: </para> <para> - <informalexample> - <programlisting> + <screen> <![CDATA[ 0: 6 1: 5 @@ -3620,8 +3876,7 @@ 3: 2 4: 1 ]]> - </programlisting> - </informalexample> + </screen> </para> <note> <para> @@ -3638,13 +3893,13 @@ <![CDATA[ function cmp ($a, $b) { return strcmp($a["frutto"], $b["frutto"]); -} +} $frutti[0]["frutto"] = "limoni"; $frutti[1]["frutto"] = "arance"; $frutti[2]["frutto"] = "uva"; -usort($frutti, "cmp"); +usort($frutti, "cmp"); while (list ($chiave, $valore) = each ($frutti)) { echo "\$frutti[$chiave]: " . $valore["frutto"] . "\n"; @@ -3661,17 +3916,15 @@ Questo esempio mostrerà: </para> <para> - <informalexample> - <programlisting> + <screen> <![CDATA[ $frutti[0]: arance $frutti[1]: limoni $frutti[2]: uva ]]> - </programlisting> - </informalexample> + </screen> </para> - + ¬e.func-callback; <para> <example> <title> @@ -3714,13 +3967,11 @@ Questo esempio mostrerà: </para> <para> - <informalexample> - <programlisting> + <screen> b c d - </programlisting> - </informalexample> + </screen> </para> <warning> <para> @@ -3730,11 +3981,11 @@ </para> </warning> <para> - Vedere anche: <function>uasort</function>, + Vedere anche <function>uasort</function>, <function>uksort</function>, <function>sort</function>, <function>asort</function>, <function>arsort</function>,<function>ksort</function>, - <function>natsort</function>, e <function>rsort</function>. + <function>natsort</function> e <function>rsort</function>. </para> </refsect1> </refentry> Index: phpdoc/it/functions/bzip2.xml diff -u phpdoc/it/functions/bzip2.xml:1.8 phpdoc/it/functions/bzip2.xml:1.9 --- phpdoc/it/functions/bzip2.xml:1.8 Sun Dec 30 19:42:47 2001 +++ phpdoc/it/functions/bzip2.xml Wed Jan 9 07:05:57 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.14 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.15 Maintainer: cucinato Status: ready --> <reference id="ref.bzip2"> <title>Funzioni di compressione Bzip2</title> <titleabbrev>Bzip2</titleabbrev> @@ -310,7 +310,7 @@ <parameter>bz</parameter>. </para> <para> - Restituisce &true; in caso di successo, &false; altrimenti. + &return.success; </para> <para> Vedere anche <function>bzread</function> e <function>bzwrite</function>.