cvs: phpdoc-it /reference/array/functions array-filter.xml array-map.xml array-multisort.xml array-splice.xml compact.xml count.xml

cucinato Mon Apr 25 06:30:56 2005 EDT Modified files: /phpdoc-it/reference/array/functions array-filter.xml array-map.xml array-multisort.xml array-splice.xml compact.xml count.xml Log: Sync with EN tree

http://cvs.php.net/diff.php/phpdoc-it/reference/array/functions/array-filter.xml?r1=1.8&r2=1.9&ty=u Index: phpdoc-it/reference/array/functions/array-filter.xml diff -u phpdoc-it/reference/array/functions/array-filter.xml:1.8 phpdoc-it/reference/array/functions/array-filter.xml:1.9 --- phpdoc-it/reference/array/functions/array-filter.xml:1.8 Sun Feb 1 06:01:00 2004 +++ phpdoc-it/reference/array/functions/array-filter.xml Mon Apr 25 06:30:55 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.14 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.16 Maintainer: cucinato Status: ready --> <!-- splitted from ./it/functions/array.xml, last change in rev 1.1 --> <!-- last change to 'array-filter' in en/ tree in rev 1.62 --> <!-- OLD-Revision: 1.173/EN.1.62 --> @@ -51,9 +51,7 @@ ?> ]]> </programlisting> - <para> - Il risultato di questo sarà: - </para> + &example.outputs; <screen role="php"> <![CDATA[ Dispari : @@ -108,9 +106,7 @@ ?> ]]> </programlisting> - <para> - Questo mostrerà: - </para> + &example.outputs; <screen> <![CDATA[ Array http://cvs.php.net/diff.php/phpdoc-it/reference/array/functions/array-map.xml?r1=1.8&r2=1.9&ty=u Index: phpdoc-it/reference/array/functions/array-map.xml diff -u phpdoc-it/reference/array/functions/array-map.xml:1.8 phpdoc-it/reference/array/functions/array-map.xml:1.9 --- phpdoc-it/reference/array/functions/array-map.xml:1.8 Sun Feb 1 06:01:00 2004 +++ phpdoc-it/reference/array/functions/array-map.xml Mon Apr 25 06:30:55 2005 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/array.xml, last change in rev 1.1 --> <!-- last change to 'array-map' in en/ tree in rev 1.62 --> -<!-- EN-Revision: 1.11 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.15 Maintainer: cucinato Status: ready --> <!-- OLD-Revision: 1.173/EN.1.62 --> <refentry id="function.array-map"> <refnamediv> @@ -14,7 +14,7 @@ <title>Descrizione</title> <methodsynopsis> <type>array</type><methodname>array_map</methodname> - <methodparam><type>mixed</type><parameter>funzione</parameter></methodparam> + <methodparam><type>callback</type><parameter>funzione</parameter></methodparam> <methodparam><type>array</type><parameter>arr1</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter>...</parameter></methodparam> </methodsynopsis> @@ -88,9 +88,7 @@ ?> ]]> </programlisting> - <para> - Questo restituisce: - </para> + &example.outputs; <screen> <![CDATA[ //stampa di $c @@ -163,12 +161,8 @@ ?> ]]> </programlisting> - </example> - </para> - <para> - Il risultato di questo programma sarà; - </para> - <screen> + &example.outputs; + <screen> <![CDATA[ Array ( @@ -209,11 +203,14 @@ ) ]]> - </screen> + </screen> + </example> + </para> <para> Vedere anche <function>array_filter</function>, - <function>array_reduce</function> e - <function>array_walk</function>. + <function>array_reduce</function>, + <function>array_walk</function> e + &seealso.callback;. </para> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-it/reference/array/functions/array-multisort.xml?r1=1.9&r2=1.10&ty=u Index: phpdoc-it/reference/array/functions/array-multisort.xml diff -u phpdoc-it/reference/array/functions/array-multisort.xml:1.9 phpdoc-it/reference/array/functions/array-multisort.xml:1.10 --- phpdoc-it/reference/array/functions/array-multisort.xml:1.9 Mon Apr 18 18:59:23 2005 +++ phpdoc-it/reference/array/functions/array-multisort.xml Mon Apr 25 06:30:55 2005 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/array.xml, last change in rev 1.1 --> <!-- last change to 'array-multisort' in en/ tree in rev 1.11 --> -<!-- EN-Revision: 1.16 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.17 Maintainer: cucinato Status: ready --> <!-- OLD-Revision: 1.173/EN.1.11 --> <refentry id="function.array-multisort"> <refnamediv> http://cvs.php.net/diff.php/phpdoc-it/reference/array/functions/array-splice.xml?r1=1.7&r2=1.8&ty=u Index: phpdoc-it/reference/array/functions/array-splice.xml diff -u phpdoc-it/reference/array/functions/array-splice.xml:1.7 phpdoc-it/reference/array/functions/array-splice.xml:1.8 --- phpdoc-it/reference/array/functions/array-splice.xml:1.7 Mon Dec 8 16:52:39 2003 +++ phpdoc-it/reference/array/functions/array-splice.xml Mon Apr 25 06:30:55 2005 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/array.xml, last change in rev 1.6 --> <!-- last change to 'array-splice' in en/ tree in rev 1.14 --> -<!-- EN-Revision: 1.9 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.15 Maintainer: cucinato Status: ready --> <!-- OLD-Revision: 1.173/EN.1.14 --> <refentry id="function.array-splice"> <refnamediv> @@ -15,7 +15,7 @@ <title>Descrizione</title> <methodsynopsis> <type>array</type><methodname>array_splice</methodname> - <methodparam><type>array</type><parameter>input</parameter></methodparam> + <methodparam><type>array</type><parameter role="reference">input</parameter></methodparam> <methodparam><type>int</type><parameter>offset</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter> @@ -57,12 +57,15 @@ <parameter>length</parameter> sono tali per cui niente viene rimosso, gli elementi dell'array <parameter>replacement</parameter> sono inseriti nella posizione specificata da - <parameter>offset</parameter>. Suggerimento: se <parameter>replacement</parameter> è composto solo da + <parameter>offset</parameter>. Si noti che le chiavi nell'array + replacement non sono conservate. + Se <parameter>replacement</parameter> è composto solo da un elemento non è necessario porlo nel costrutto <literal>array()</literal>, a meno che l'elemento stesso non sia un array. </para> <para> - Valgono le seguenti equivalenze: + Le seguenti espressione cambiano i valori di <varname>$input</varname> + nello stesso modo: <table> <title><function>array_splice</function> equivalents</title> <tgroup cols="2"> @@ -88,7 +91,7 @@ array_shift($input) </entry> <entry> - array_splice($input, -1) + array_splice($input, 0, 1) </entry> </row> <row> @@ -101,7 +104,7 @@ </row> <row> <entry> - $a[$x] = $y + $input[$x] = $y // negli array in cui la chiave è uguale alla posizione </entry> <entry> array_splice($input, $x, 1, $y) http://cvs.php.net/diff.php/phpdoc-it/reference/array/functions/compact.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-it/reference/array/functions/compact.xml diff -u phpdoc-it/reference/array/functions/compact.xml:1.4 phpdoc-it/reference/array/functions/compact.xml:1.5 --- phpdoc-it/reference/array/functions/compact.xml:1.4 Mon Dec 8 18:00:36 2003 +++ phpdoc-it/reference/array/functions/compact.xml Mon Apr 25 06:30:55 2005 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/array.xml, last change in rev 1.1 --> <!-- last change to 'compact' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.7 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.8 Maintainer: cucinato Status: ready --> <!-- OLD-Revision: 1.173/EN.1.2 --> <refentry id="function.compact"> <refnamediv> @@ -33,8 +33,18 @@ Restituisce l'array di output con tutte le variabili aggiunte a quest'ultimo. </para> <para> - Qualsiasi stringa non valorizzata verr&agrave; semplicemente ignorata. + Qualsiasi stringa non valorizzata verrà semplicemente ignorata. </para> + <note> + <title>Gotcha</title> + <para> + Dal momento che le <link linkend="language.variables.variable">variabili + variabili</link> non posso essere utilizzate con gli + <link linkend="language.variables.superglobals">array + Superglobal</link> di PHP nelle funzioni, gli array Superglobal non possono essere passati + alla funzione <function>compact</function>. + </para> + </note> <para> <example> <title>esempio di <function>compact</function></title> http://cvs.php.net/diff.php/phpdoc-it/reference/array/functions/count.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-it/reference/array/functions/count.xml diff -u phpdoc-it/reference/array/functions/count.xml:1.5 phpdoc-it/reference/array/functions/count.xml:1.6 --- phpdoc-it/reference/array/functions/count.xml:1.5 Sat Jan 3 09:39:14 2004 +++ phpdoc-it/reference/array/functions/count.xml Mon Apr 25 06:30:55 2005 @@ -1,12 +1,12 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/array.xml, last change in rev 1.1 --> <!-- last change to 'count' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.11 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 1.17 Maintainer: cucinato Status: ready --> <!-- OLD-Revision: 1.173/EN.1.2 --> <refentry id="function.count"> <refnamediv> <refname>count</refname> - <refpurpose>Conta gli elementi in una variabile</refpurpose> + <refpurpose>Conta gli elementi in una variabile, o le proprietà in un oggetto</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> @@ -17,13 +17,23 @@ </methodsynopsis> <para> Restituisce il numero di elementi in <parameter>var</parameter>, - la quale è di norma un array (dal momento che qualsiasi altro oggetto avrà un - elemento). + la quale è di norma un <type>array</type>, dal momento che qualsiasi altro oggetto + avrà un elemento. </para> <para> - Se <parameter>var</parameter> non è un array, verrà restituito <literal>1</literal> - (eccezione: <literal>count(&null;)</literal> restituisce - <literal>0</literal>). + Per gli oggetti, se + <link linkend="ref.spl">SPL</link> è installato, è possibile agganciarsi a + <function>count</function> implementando l'interfaccia + <literal>Countable</literal>. L'interfaccia ha esattamente un metodo, + <function>count</function>, che ritorna il valore restituito dalla + funzione <function>count</function>. + </para> + <para> + Se <parameter>var</parameter> non è un array o un oggetto con + l'interfaccia <literal>Countable</literal> implementata, + verrà restituito <literal>1</literal> + C'è una eccezione, se <parameter>var</parameter> è &null;, + verrà restituito <literal>0</literal>. </para> <note> <simpara> @@ -37,6 +47,7 @@ conterà ricorsivamente l'array. Questo è utile in particolare per contare tutti gli elementi di un array multidimensionale. Il valore di default per <parameter>mode</parameter> è <literal>0</literal>. + <function>count</function> non identifica le ricorsioni infinite. </para> <caution> <para> @@ -47,15 +58,14 @@ </para> </caution> <para> - Vedere la sezione <link linkend="language.types.array">Arrays</link> + Vedere la sezione <link linkend="language.types.array">Array</link> nel manuale per una spiegazione dettagliata di come gli array siano implementati ed usati in PHP. - </para> + </para> <para> <example> <title>esempio di <function>count</function></title> <programlisting role="php"> - <!-- TODO: examples about count(null), count(false), count(object).. --> <![CDATA[ <?php $a[0] = 1; @@ -69,6 +79,12 @@ $b[10] = 11; $risultato = count($b); // $risultato == 3; + +$result = count(null); +// $result == 0 + +$result = count(false); +// $result == 1 ?> ]]> </programlisting> @@ -96,12 +112,6 @@ </programlisting> </example> </para> - <note> - <para> - La funzione <function>sizeof</function> &egrave; un - <link linkend="aliases">alias</link> per <function>count</function>. - </para> - </note> <para> Vedere anche <function>is_array</function>, <function>isset</function> e