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>.
