Sophie

Sophie

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

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
>array</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="array_walk"
HREF="function.array-walk.html"><LINK
REL="NEXT"
TITLE="arsort"
HREF="function.arsort.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.array-walk.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.arsort.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.array"
></A
>array</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN12190"
></A
><P
>    (PHP 3, PHP 4, PHP 5)</P
>array&nbsp;--&nbsp;Cria um array</DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN12193"
></A
><H2
>Descrição</H2
>array <B
CLASS="methodname"
>array</B
> ( [mixed ...] )<BR
></BR
><P
>&#13;     Retorna um array a partir dos valores fornecidos. Índices podem ser atribuidos
     aos valores através do operador <TT
CLASS="literal"
>=&#62;</TT
>.
     leia a seção sobre o <A
HREF="language.types.array.html"
>tipo array(matriz)</A
>
     para maiores informações sobre o que é uma matriz.
    </P
><P
>&#13;     <DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
       <B
CLASS="function"
>array()</B
> é uma estrutura utilizada para representar
       literais de arrays, e não uma função.
      </P
></BLOCKQUOTE
></DIV
>
    </P
><P
>&#13;     A sintaxe "index =&#62; values", separados por vírgulas, definem índice e
     valores respectivamente. O índice por de ser do tipo string ou numérico.
     Quando o índice é omitido, um índice numérico inteiro é automaticamente
     gerado, começando do 0. Se o índice é um inteiro, o próximo índice a ser
     gerado será igual ao maior índice inteiro + 1. Note que quando dois
     índices idênticos são definidos, o último sobrescreve o primeiro.
    </P
><P
>&#13;     O exemplo a seguir demonstra como criar um array com duas dimensões, como
     especificar chaves em arrays associativos, e como definir índices
     numéricos em arrays normais.
     Tem uma vírgula após a ultima entrada definida da matriz, mesmo
     sendo incomum, é uma sintaxe válida.
    </P
><P
>&#13;     <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN12211"
></A
><P
><B
>Exemplo 1. Exemplo de <B
CLASS="function"
>array()</B
></B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br />$frutas </font><font color="#007700">= array (<br />&nbsp;&nbsp;&nbsp;&nbsp;</font><font color="#DD0000">"frutas" </font><font color="#007700">=&gt; array(</font><font color="#DD0000">"a"</font><font color="#007700">=&gt;</font><font color="#DD0000">"laranja"</font><font color="#007700">, </font><font color="#DD0000">"b"</font><font color="#007700">=&gt;</font><font color="#DD0000">"banana"</font><font color="#007700">, </font><font color="#DD0000">"c"</font><font color="#007700">=&gt;</font><font color="#DD0000">"maçã"</font><font color="#007700">),<br />&nbsp;&nbsp;&nbsp;&nbsp;</font><font color="#DD0000">"numeros" </font><font color="#007700">=&gt; array(</font><font color="#0000BB">1</font><font color="#007700">, </font><font color="#0000BB">2</font><font color="#007700">, </font><font color="#0000BB">3</font><font color="#007700">, </font><font color="#0000BB">4</font><font color="#007700">, </font><font color="#0000BB">5</font><font color="#007700">, </font><font color="#0000BB">6</font><font color="#007700">),<br />&nbsp;&nbsp;&nbsp;&nbsp;</font><font color="#DD0000">"buracos" </font><font color="#007700">=&gt; array(</font><font color="#DD0000">"primeiro"</font><font color="#007700">, </font><font color="#0000BB">5 </font><font color="#007700">=&gt; </font><font color="#DD0000">"segundo"</font><font color="#007700">, </font><font color="#DD0000">"terceiro"</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="AEN12216"
></A
><P
><B
>Exemplo 2. Indexação automática com <B
CLASS="function"
>array()</B
></B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br />$array </font><font color="#007700">= array(</font><font color="#0000BB">1</font><font color="#007700">, </font><font color="#0000BB">1</font><font color="#007700">, </font><font color="#0000BB">1</font><font color="#007700">, </font><font color="#0000BB">1</font><font color="#007700">,&nbsp;&nbsp;</font><font color="#0000BB">1</font><font color="#007700">, </font><font color="#0000BB">8 </font><font color="#007700">=&gt; </font><font color="#0000BB">1</font><font color="#007700">,&nbsp;&nbsp;</font><font color="#0000BB">4 </font><font color="#007700">=&gt; </font><font color="#0000BB">1</font><font color="#007700">, </font><font color="#0000BB">19</font><font color="#007700">, </font><font color="#0000BB">3 </font><font color="#007700">=&gt; </font><font color="#0000BB">13</font><font color="#007700">);<br /></font><font color="#0000BB">print_r</font><font color="#007700">(</font><font color="#0000BB">$array</font><font color="#007700">);<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
><P
>O exemplo acima irá imprimir:</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
Array<br />(<br />&nbsp;&nbsp;&nbsp;&nbsp;[0] =&gt; 1<br />&nbsp;&nbsp;&nbsp;&nbsp;[1] =&gt; 1<br />&nbsp;&nbsp;&nbsp;&nbsp;[2] =&gt; 1<br />&nbsp;&nbsp;&nbsp;&nbsp;[3] =&gt; 13<br />&nbsp;&nbsp;&nbsp;&nbsp;[4] =&gt; 1<br />&nbsp;&nbsp;&nbsp;&nbsp;[8] =&gt; 1<br />&nbsp;&nbsp;&nbsp;&nbsp;[9] =&gt; 19<br />)</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
     </P
><P
>&#13;     Note que o índice 3 é definido duas vezes, e retêm seu último valor
     13. O índice 4 é definido depois do índice 8, e o índice gerado depois
     dele foi 9, uma vez que o maior índice era 8.
    </P
><P
>&#13;     Esse exemplo cria um array com o índices a partir do 1.
     <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN12224"
></A
><P
><B
>Exemplo 3. Array com índices a partir do 1 com <B
CLASS="function"
>array()</B
></B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br />$firstquarter </font><font color="#007700">= array(</font><font color="#0000BB">1 </font><font color="#007700">=&gt; </font><font color="#DD0000">'January'</font><font color="#007700">, </font><font color="#DD0000">'February'</font><font color="#007700">,</font><font color="#DD0000">'March'</font><font color="#007700">);<br /></font><font color="#0000BB">print_r</font><font color="#007700">(</font><font color="#0000BB">$firstquarter</font><font color="#007700">);<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
><P
>O exemplo acima irá imprimir:</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="screen"
>Array
(
    [1] =&#62; Janeiro
    [2] =&#62; Fevereiro
    [3] =&#62; Marco
)</PRE
></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
    </P
><P
>&#13;     Como no Perl, você pode acessar o valor de um array dentro de aspas.
     Entretanto, você terá que colocar a sua array dentro de conchetes.
    <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN12231"
></A
><P
><B
>Exemplo 4. Acessando uma matriz dentro de conchetes</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br /><br />$foo </font><font color="#007700">= array(</font><font color="#DD0000">'bar' </font><font color="#007700">=&gt; </font><font color="#DD0000">'baz'</font><font color="#007700">);<br />echo </font><font color="#DD0000">"Hello </font><font color="#007700">{</font><font color="#DD0000">$foo</font><font color="#007700">[</font><font color="#DD0000">'bar'</font><font color="#007700">]}</font><font color="#DD0000">!"</font><font color="#007700">; </font><font color="#FF8000">// Hello baz!<br /><br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
    </P
><P
>&#13;     Veja também <A
HREF="function.array-pad.html"
><B
CLASS="function"
>array_pad()</B
></A
>,
     <A
HREF="function.list.html"
><B
CLASS="function"
>list()</B
></A
>, <A
HREF="control-structures.foreach.html"
>foreach</A
>
     e <A
HREF="function.range.html"
><B
CLASS="function"
>range()</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.array-walk.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.arsort.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>array_walk</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"
>arsort</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>