Sophie

Sophie

distrib > Mandriva > 2008.1 > i586 > by-pkgid > 703d980c580707c382b4e43e25965bc5 > files > 7521

php-manual-pt_BR-5.2.4-1mdv2008.1.noarch.rpm

<!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&nbsp;--&nbsp;
     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
>&#13;     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
>&#13;     <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">&lt;?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">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
    </P
><P
>&#13;     <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">
&lt;table&gt;<br /> &lt;tr&gt;<br />&nbsp;&nbsp;&lt;th&gt;Lista de empregados&lt;/th&gt;<br />&nbsp;&nbsp;&lt;th&gt;Salário&lt;/th&gt;<br /> &lt;/tr&gt;<br /><br /><font color="#0000BB">&lt;?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 />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;echo </font><font color="#DD0000">" &lt;tr&gt;\n" </font><font color="#007700">.<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</font><font color="#DD0000">"&nbsp;&nbsp;&lt;td&gt;&lt;a href=</font><font color="#007700">\"</font><font color="#DD0000">info.php?id=$id</font><font color="#007700">\"</font><font color="#DD0000">&gt;$nome&lt;/a&gt;&lt;/td&gt;</font><font color="#007700">\n</font><font color="#DD0000">" </font><font color="#007700">.<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</font><font color="#DD0000">"&nbsp;&nbsp;&lt;td&gt;$salario&lt;/td&gt;</font><font color="#007700">\n</font><font color="#DD0000">" </font><font color="#007700">.<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</font><font color="#DD0000">" &lt;/tr&gt;\n"</font><font color="#007700">;<br />}<br /><br /></font><font color="#0000BB">?&gt;<br /></font><br />&lt;/table&gt;</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
>&#13;     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
>&#13;     <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">&lt;?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">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
><P
>&#13;     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]=&#62;
  string(8) "cafeína"
  [1]=&#62;
  string(5) "marrom"
  [0]=&#62;
  string(6) "café"
}</PRE
></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>  
     </P
><P
>&#13;     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
>