[PHP-DOC] cvs: phpdoc-it /reference/array/functions list.xml

[Marco Cucinato]

cucinato                Wed Jun 12 02:49:01 2002 EDT

  Modified files:              
    /phpdoc-it/reference/array/functions        list.xml 
  Log:
  Updated to EN version
  
  
Index: phpdoc-it/reference/array/functions/list.xml
diff -u phpdoc-it/reference/array/functions/list.xml:1.3 
phpdoc-it/reference/array/functions/list.xml:1.4
--- phpdoc-it/reference/array/functions/list.xml:1.3    Sun May 12 18:14:11 2002
+++ phpdoc-it/reference/array/functions/list.xml        Wed Jun 12 02:49:00 2002
@@ -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 'list' in en/ tree in rev 1.2 -->
-<!-- EN-Revision: 1.4 Maintainer: cucinato Status: ready -->
+<!-- EN-Revision: 1.5 Maintainer: cucinato Status: ready -->
 <!-- OLD-Revision: 1.173/EN.1.2 -->
   <refentry id="function.list">
    <refnamediv>
@@ -17,8 +17,8 @@
       <methodparam 
rep="repeat"><type>mixed</type><parameter>...</parameter></methodparam>
      </methodsynopsis>
     <para>
-     Come <function>array</function>, questa non &egrave; in realt&agrave; una 
funzione,
-     bens&igrave; un costrutto del linguaggio.  <function>list</function> &egrave; 
usata per
+     Come <function>array</function>, questa non � in realt� una funzione,
+     bens� un costrutto del linguaggio.  <function>list</function> � usata per
      assegnare valori ad una lista di variabili in una sola operazione.
     </para>
     <note>
@@ -80,6 +80,44 @@
 ]]>
       </programlisting>
      </example>
+    </para>
+    <warning>
+    <para>
+     <function>list</function> assegna i valori cominciando dal parametro pi� a
+     destra. Se si stanno usando variabili semplici, non ci si deve preoccupare
+     di questo fatto. Ma se si stanno usando array con indici di solito ci si aspetta 
+che
+     l'ordine degli indici negli array sia quello scritto negli argomenti della 
+funzione
+     <function>list</function>, da sinistra a destra; non � cos�. L'ordine �
+     invertito.
+    </para>
+   </warning>
+   <para>
+    <example>
+     <title>Utilizzo di <function>list</function> con gli indici</title>
+     <programlisting role="php">
+<![CDATA[
+<?php
+
+$info = array('caff�', 'nero', 'caffeina');
+
+list($a[0], $a[1], $a[2]) = $info;
+
+var_dump($a);
+]]>
+      </programlisting>
+     </example>
+     Restituisce il segente risultato (si noti l'ordine degli elementi rispetto
+     all'ordine con cui sono stati scritti nella sintassi di 
+<function>list</function>).
+     <screen>
+array(3) {
+  [2]=>
+  string(8) "caffeina"
+  [1]=>
+  string(4) "nero"
+  [0]=>
+  string(5) "caff�"
+}
+     </screen>
     </para>
     <para>
      Vedere anche <function>each</function> e <function>array</function>