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 è in realtà una
funzione,
- bensì un costrutto del linguaggio. <function>list</function> è
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>
