<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <HTML ><HEAD ><TITLE >list</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK REL="HOME" TITLE="Manual do PHP" HREF="index.html"><LINK REL="UP" TITLE="Arrays" HREF="ref.array.html"><LINK REL="PREVIOUS" TITLE="ksort" HREF="function.ksort.html"><LINK REL="NEXT" TITLE="natcasesort" HREF="function.natcasesort.html"><META HTTP-EQUIV="Content-type" CONTENT="text/html; charset=UTF-8"></HEAD ><BODY CLASS="refentry" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >Manual do PHP</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="function.ksort.html" ACCESSKEY="P" >Anterior</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="function.natcasesort.html" ACCESSKEY="N" >Próxima</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="function.list" ></A >list</H1 ><DIV CLASS="refnamediv" ><A NAME="AEN12790" ></A ><P > (PHP 3, PHP 4, PHP 5)</P >list -- Cria variáveis como se fossem arrays </DIV ><DIV CLASS="refsect1" ><A NAME="AEN12793" ></A ><H2 >Descrição</H2 >void <B CLASS="methodname" >list</B > ( mixed ... )<BR ></BR ><P > Assim como <A HREF="function.array.html" ><B CLASS="function" >array()</B ></A >, não é exatamente uma função, e sim uma construção da própria linguagem. <B CLASS="function" >list()</B > é usada para criar uma lista de variáveis em apenas um operação. </P ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Nota: </B > <B CLASS="function" >list()</B > só funciona em arrays com índices numéricos e assume que esses índices começam de 0 (zero). </P ></BLOCKQUOTE ></DIV ><P > <TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" CLASS="EXAMPLE" ><TR ><TD ><DIV CLASS="example" ><A NAME="AEN12808" ></A ><P ><B >Exemplo 1. Exemplo de <B CLASS="function" >list()</B ></B ></P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><code><font color="#000000"> <font color="#0000BB"><?php<br /><br />$info </font><font color="#007700">= array(</font><font color="#DD0000">'Café'</font><font color="#007700">, </font><font color="#DD0000">'marrom'</font><font color="#007700">, </font><font color="#DD0000">'cafeína'</font><font color="#007700">);<br /><br /></font><font color="#FF8000">// Listando todas as variáveis<br /></font><font color="#007700">list(</font><font color="#0000BB">$bebida</font><font color="#007700">, </font><font color="#0000BB">$cor</font><font color="#007700">, </font><font color="#0000BB">$substancia</font><font color="#007700">) = </font><font color="#0000BB">$info</font><font color="#007700">;<br />print </font><font color="#DD0000">"$bebida is $cor e $substancia a faz especial.</font><font color="#007700">\n</font><font color="#DD0000">"</font><font color="#007700">;<br /><br /></font><font color="#FF8000">// Listando apenas alguns deles<br /></font><font color="#007700">list(</font><font color="#0000BB">$bebida</font><font color="#007700">, , </font><font color="#0000BB">$substanciar</font><font color="#007700">) = </font><font color="#0000BB">$info</font><font color="#007700">;<br />print </font><font color="#DD0000">"$bebida tem $substancia.</font><font color="#007700">\n</font><font color="#DD0000">"</font><font color="#007700">;<br /><br /></font><font color="#FF8000">// Ou ignoramos os primeiros valores para conseguir apenas o último <br /></font><font color="#007700">list( , , </font><font color="#0000BB">$substancia</font><font color="#007700">) = </font><font color="#0000BB">$info</font><font color="#007700">;<br />print </font><font color="#DD0000">"I need $substancia!</font><font color="#007700">\n</font><font color="#DD0000">"</font><font color="#007700">;<br /><br /></font><font color="#0000BB">?></font> </font> </code></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE > </P ><P > <TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" CLASS="EXAMPLE" ><TR ><TD ><DIV CLASS="example" ><A NAME="AEN12813" ></A ><P ><B >Exemplo 2. Exemplo de <B CLASS="function" >list()</B ></B ></P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><code><font color="#000000"> <table><br /> <tr><br /> <th>Lista de empregados</th><br /> <th>Salário</th><br /> </tr><br /><br /><font color="#0000BB"><?php<br /><br />$result </font><font color="#007700">= </font><font color="#0000BB">mysql_query </font><font color="#007700">(</font><font color="#DD0000">"SELECT id, nome, salario FROM empregados"</font><font color="#007700">, </font><font color="#0000BB">$conn</font><font color="#007700">);<br />while (list (</font><font color="#0000BB">$id</font><font color="#007700">, </font><font color="#0000BB">$nome</font><font color="#007700">, </font><font color="#0000BB">$salario</font><font color="#007700">) = </font><font color="#0000BB">mysql_fetch_row </font><font color="#007700">(</font><font color="#0000BB">$result</font><font color="#007700">)) {<br /> echo </font><font color="#DD0000">" <tr>\n" </font><font color="#007700">.<br /> </font><font color="#DD0000">" <td><a href=</font><font color="#007700">\"</font><font color="#DD0000">info.php?id=$id</font><font color="#007700">\"</font><font color="#DD0000">>$nome</a></td></font><font color="#007700">\n</font><font color="#DD0000">" </font><font color="#007700">.<br /> </font><font color="#DD0000">" <td>$salario</td></font><font color="#007700">\n</font><font color="#DD0000">" </font><font color="#007700">.<br /> </font><font color="#DD0000">" </tr>\n"</font><font color="#007700">;<br />}<br /><br /></font><font color="#0000BB">?><br /></font><br /></table></font> </code></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE > </P ><DIV CLASS="warning" ><P ></P ><TABLE CLASS="warning" BORDER="1" WIDTH="100%" ><TR ><TD ALIGN="CENTER" ><B >Atenção</B ></TD ></TR ><TR ><TD ALIGN="LEFT" ><P > A função <B CLASS="function" >list()</B > assinala os valores começando pelos parâmetros da direita. Se você está usando variáveis normais, então não precisa se preocupar com esse detalhe. Mas se você está usando arrays com índices você normalmente iria esperar que a ordem dos índices no array fosse da esquerda para a direita, mas não é isso que acontece. O índice é criado na ordem reversa. </P ></TD ></TR ></TABLE ></DIV ><P > <TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" CLASS="EXAMPLE" ><TR ><TD ><DIV CLASS="example" ><A NAME="AEN12821" ></A ><P ><B >Exemplo 3. Usando <B CLASS="function" >list()</B > com índices de array</B ></P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><code><font color="#000000"> <font color="#0000BB"><?php<br /><br />$info </font><font color="#007700">= array(</font><font color="#DD0000">'café'</font><font color="#007700">, </font><font color="#DD0000">'marrom'</font><font color="#007700">, </font><font color="#DD0000">'cafeína'</font><font color="#007700">);<br /><br />list(</font><font color="#0000BB">$a</font><font color="#007700">[</font><font color="#0000BB">0</font><font color="#007700">], </font><font color="#0000BB">$a</font><font color="#007700">[</font><font color="#0000BB">1</font><font color="#007700">], </font><font color="#0000BB">$a</font><font color="#007700">[</font><font color="#0000BB">2</font><font color="#007700">]) = </font><font color="#0000BB">$info</font><font color="#007700">;<br /><br /></font><font color="#0000BB">var_dump</font><font color="#007700">(</font><font color="#0000BB">$a</font><font color="#007700">);<br /><br /></font><font color="#0000BB">?></font> </font> </code></TD ></TR ></TABLE ><P > O retorno desse script é o seguinte (note a ordem dos elementos em comparação com o array original): </P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><PRE CLASS="screen" >array(3) { [2]=> string(8) "cafeína" [1]=> string(5) "marrom" [0]=> string(6) "café" }</PRE ></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE > </P ><P > Veja também <A HREF="function.each.html" ><B CLASS="function" >each()</B ></A >, <A HREF="function.array.html" ><B CLASS="function" >array()</B ></A > e <A HREF="function.extract.html" ><B CLASS="function" >extract()</B ></A >. </P ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="function.ksort.html" ACCESSKEY="P" >Anterior</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Principal</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="function.natcasesort.html" ACCESSKEY="N" >Próxima</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >ksort</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="ref.array.html" ACCESSKEY="U" >Acima</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >natcasesort</TD ></TR ></TABLE ></DIV ></BODY ></HTML >