<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Arrays</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="Tipos"
HREF="language.types.html"><LINK
REL="PREVIOUS"
TITLE="Strings"
HREF="language.types.string.html"><LINK
REL="NEXT"
TITLE="Objetos"
HREF="language.types.object.html"><META
HTTP-EQUIV="Content-type"
CONTENT="text/html; charset=UTF-8"></HEAD
><BODY
CLASS="sect1"
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="language.types.string.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Capítulo 11. Tipos</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="language.types.object.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="language.types.array"
>Arrays</A
></H1
><P
> Um array no PHP é atualmente um mapa ordenado. Um mapa é um tipo que
relaciona <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>valores</I
></SPAN
> para <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>chaves</I
></SPAN
>.
Este tipo é otimizado de várias maneiras,
então você pode usá-lo como um array real, ou uma lista (vetor),
hashtable (que é uma implementação de mapa),
dicionário, coleção,
pilha, fila e provavelmente mais. Como você pode ter outro
array PHP como um valor, você pode facilmente simular
árvores.
</P
><P
> A explicação dessas estruturas estão além do escopo desse
manual, mas você pode encontrar exemplos para cada uma dessas estruturas a seguir.
Para mais informações sobre estruturas, refira-se a literatura externa sobre
esses tópicos.
</P
><DIV
CLASS="sect2"
><H2
CLASS="sect2"
><A
NAME="language.types.array.syntax"
>Sintaxe</A
></H2
><DIV
CLASS="sect3"
><H3
CLASS="sect3"
><A
NAME="language.types.array.syntax.array-func"
>Especificando com <A
HREF="function.array.html"
><B
CLASS="function"
>array()</B
></A
></A
></H3
><P
> Um <A
HREF="language.types.array.html"
><B
CLASS="type"
>array</B
></A
> pode ser criado com o construtor de linguagem
<A
HREF="function.array.html"
><B
CLASS="function"
>array()</B
></A
>. Ele pega um certo número de pares separados por vírgula
<TT
CLASS="literal"
><TT
CLASS="replaceable"
><I
>chave</I
></TT
> => <TT
CLASS="replaceable"
><I
>valor</I
></TT
></TT
>
.
</P
><P
> <TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="synopsis"
>array( [<TT
CLASS="replaceable"
><I
>chave</I
></TT
> =>] <TT
CLASS="replaceable"
><I
>valor</I
></TT
>
, ...
)
// <TT
CLASS="replaceable"
><I
>chave</I
></TT
> pode ser tanto <A
HREF="language.types.string.html"
><B
CLASS="type"
>string</B
></A
> ou um <A
HREF="language.types.integer.html"
><B
CLASS="type"
>integer</B
></A
>
// <TT
CLASS="replaceable"
><I
>valor</I
></TT
> pode ser qualquer coisa</PRE
></TD
></TR
></TABLE
>
</P
><P
> <DIV
CLASS="informalexample"
><P
></P
><A
NAME="AEN3244"
></A
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB"><?php<br />$arr </font><font color="#007700">= array(</font><font color="#DD0000">"foo" </font><font color="#007700">=> </font><font color="#DD0000">"bar"</font><font color="#007700">, </font><font color="#0000BB">12 </font><font color="#007700">=> </font><font color="#0000BB">true</font><font color="#007700">);<br /><br />echo </font><font color="#0000BB">$arr</font><font color="#007700">[</font><font color="#DD0000">"foo"</font><font color="#007700">]; </font><font color="#FF8000">// bar<br /></font><font color="#007700">echo </font><font color="#0000BB">$arr</font><font color="#007700">[</font><font color="#0000BB">12</font><font color="#007700">]; </font><font color="#FF8000">// 1<br /></font><font color="#0000BB">?></font>
</font>
</code></TD
></TR
></TABLE
><P
></P
></DIV
>
</P
><P
> A <CODE
CLASS="varname"
>chave</CODE
> pode ser tanto um
<A
HREF="language.types.integer.html"
><B
CLASS="type"
>integer</B
></A
> ou uma <A
HREF="language.types.string.html"
><B
CLASS="type"
>string</B
></A
>. Se a chave
é uma representação padrão de um <A
HREF="language.types.integer.html"
><B
CLASS="type"
>integer</B
></A
>, ele será
interpretado assim (por exemplo, <TT
CLASS="literal"
>"8"</TT
> será
interpretado como <TT
CLASS="literal"
>8</TT
>, enquanto
<TT
CLASS="literal"
>"08"</TT
> será interpretado como
<TT
CLASS="literal"
>"08"</TT
>). Não há diferença entre arrais indexados e
associativos em PHP, apenas um tipo de array,
que pode ter índices inteiros ou string.
</P
><P
> O valor pode ser qualquer tipo PHP:
<DIV
CLASS="informalexample"
><P
></P
><A
NAME="AEN3256"
></A
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB"><?php<br />$arr </font><font color="#007700">= array(</font><font color="#DD0000">"somearray" </font><font color="#007700">=> array(</font><font color="#0000BB">6 </font><font color="#007700">=> </font><font color="#0000BB">5</font><font color="#007700">, </font><font color="#0000BB">13 </font><font color="#007700">=> </font><font color="#0000BB">9</font><font color="#007700">, </font><font color="#DD0000">"a" </font><font color="#007700">=> </font><font color="#0000BB">42</font><font color="#007700">));<br /><br />echo </font><font color="#0000BB">$arr</font><font color="#007700">[</font><font color="#DD0000">"somearray"</font><font color="#007700">][</font><font color="#0000BB">6</font><font color="#007700">]; </font><font color="#FF8000">// 5<br /></font><font color="#007700">echo </font><font color="#0000BB">$arr</font><font color="#007700">[</font><font color="#DD0000">"somearray"</font><font color="#007700">][</font><font color="#0000BB">13</font><font color="#007700">]; </font><font color="#FF8000">// 9<br /></font><font color="#007700">echo </font><font color="#0000BB">$arr</font><font color="#007700">[</font><font color="#DD0000">"somearray"</font><font color="#007700">][</font><font color="#DD0000">"a"</font><font color="#007700">]; </font><font color="#FF8000">// 42<br /></font><font color="#0000BB">?></font>
</font>
</code></TD
></TR
></TABLE
><P
></P
></DIV
>
</P
><P
> Se omitir a chave quando fornece um novo item, o maior
índice inteiro é obtido, e a nova chave será esse
máximo + 1. Se você especificar uma chave que já possui um valor
assimilada a ela, então o valor é sobrescrito.
<DIV
CLASS="informalexample"
><P
></P
><A
NAME="AEN3259"
></A
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB"><?php<br /></font><font color="#FF8000">// Esse array eh como ...<br /></font><font color="#007700">array(</font><font color="#0000BB">5 </font><font color="#007700">=> </font><font color="#0000BB">43</font><font color="#007700">, </font><font color="#0000BB">32</font><font color="#007700">, </font><font color="#0000BB">56</font><font color="#007700">, </font><font color="#DD0000">"b" </font><font color="#007700">=> </font><font color="#0000BB">12</font><font color="#007700">);<br /><br /></font><font color="#FF8000">// ... este array<br /></font><font color="#007700">array(</font><font color="#0000BB">5 </font><font color="#007700">=> </font><font color="#0000BB">43</font><font color="#007700">, </font><font color="#0000BB">6 </font><font color="#007700">=> </font><font color="#0000BB">32</font><font color="#007700">, </font><font color="#0000BB">7 </font><font color="#007700">=> </font><font color="#0000BB">56</font><font color="#007700">, </font><font color="#DD0000">"b" </font><font color="#007700">=> </font><font color="#0000BB">12</font><font color="#007700">);<br /></font><font color="#0000BB">?></font>
</font>
</code></TD
></TR
></TABLE
><P
></P
></DIV
>
</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 partir do PHP 4.3.0, o comportamento da geração de índice descrito
acima foi modificado. Agora, se você aumentar um array em que
o maior índice atual for negativo, então a próxima chave
criada será zero (<TT
CLASS="literal"
>0</TT
>). Antes, o novo
índice seria o maior índice existente mais 1,
do mesmo jeito que os índices positivos.
</P
></TD
></TR
></TABLE
></DIV
><P
> Utilizar <TT
CLASS="constant"
><B
>TRUE</B
></TT
> como chave será interpretado como o <A
HREF="language.types.integer.html"
><B
CLASS="type"
>integer</B
></A
>
<TT
CLASS="literal"
>1</TT
> na chave. Utilizando <TT
CLASS="constant"
><B
>FALSE</B
></TT
> como chave será
avaliado como o <A
HREF="language.types.integer.html"
><B
CLASS="type"
>integer</B
></A
> <TT
CLASS="literal"
>0</TT
>.
Usar <TT
CLASS="literal"
>NULL</TT
> como chave é interpretado como uma string
vazia. Usar uma string vazia como chave irá criar (ou sobrescerver)
uma chave com uma string vazia e seu valor, e isto não é o mesmo que
usar colchetes vazios.
</P
><P
> Você não pode usar arrays ou objetos como chaves. Fazendo isso resultará em um
alerta: <TT
CLASS="literal"
>Illegal offset type</TT
>.
</P
></DIV
><DIV
CLASS="sect3"
><H3
CLASS="sect3"
><A
NAME="language.types.array.syntax.modifying"
>Criando/modificando com a sintaxe de colchetes</A
></H3
><P
> Você pode também modificar um array existente explicitamente assimilando
valores nele.
</P
><P
> Isto é feito apenas assimilando valores para o array enquanto especificando a
chave em colchetes. Você pode omitir a chave, colocando um par vazio
de colchetes ("<TT
CLASS="literal"
>[]</TT
>").
<TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="synopsis"
>$arr[<TT
CLASS="replaceable"
><I
>chave</I
></TT
>] = <TT
CLASS="replaceable"
><I
>valor</I
></TT
>;
$arr[] = <TT
CLASS="replaceable"
><I
>valor</I
></TT
>;
// <TT
CLASS="replaceable"
><I
>chave</I
></TT
> tanto um <A
HREF="language.types.integer.html"
><B
CLASS="type"
>integer</B
></A
> ou <A
HREF="language.types.string.html"
><B
CLASS="type"
>string</B
></A
>
// <TT
CLASS="replaceable"
><I
>valor</I
></TT
> pode ser qualquer coisa</PRE
></TD
></TR
></TABLE
>
Se <CODE
CLASS="varname"
>$arr</CODE
> não existir ainda, ele será criado.
Então isto é um meio alternativo para especificar um array.
Para mudar um certo valor, apenas assimile um novo valor
para um elemento especificado por sua chave. Se você quiser
remover um par chave/valor, você precisa aplicar <A
HREF="function.unset.html"
><B
CLASS="function"
>unset()</B
></A
> nele.
<DIV
CLASS="informalexample"
><P
></P
><A
NAME="AEN3289"
></A
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB"><?php<br />$arr </font><font color="#007700">= array(</font><font color="#0000BB">5 </font><font color="#007700">=> </font><font color="#0000BB">1</font><font color="#007700">, </font><font color="#0000BB">12 </font><font color="#007700">=> </font><font color="#0000BB">2</font><font color="#007700">);<br /><br /></font><font color="#0000BB">$arr</font><font color="#007700">[] = </font><font color="#0000BB">56</font><font color="#007700">; </font><font color="#FF8000">// Isto eh o mesmo que $arr[13] = 56;<br /> // nesse ponto do script<br /><br /></font><font color="#0000BB">$arr</font><font color="#007700">[</font><font color="#DD0000">"x"</font><font color="#007700">] = </font><font color="#0000BB">42</font><font color="#007700">; </font><font color="#FF8000">// Isto acrescenta um novo elemento<br /> // para o array com a chave "x"<br /><br /></font><font color="#007700">unset(</font><font color="#0000BB">$arr</font><font color="#007700">[</font><font color="#0000BB">5</font><font color="#007700">]); </font><font color="#FF8000">// Isto remove um elemento do array<br /><br /></font><font color="#007700">unset(</font><font color="#0000BB">$arr</font><font color="#007700">); </font><font color="#FF8000">// E isto apaga todo o array<br /></font><font color="#0000BB">?></font>
</font>
</code></TD
></TR
></TABLE
><P
></P
></DIV
>
</P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
Como mencionado acima, não informar a chave dentro dos
colchetes, então o maior índice inteiro é
obtido, e a nova chave será esse máximo + 1. Se nenhum
índice inteiro existir ainda, a chave será <TT
CLASS="literal"
>0</TT
>
(zero). Se você especificar uma chave que já possui um valor assimilada
a ela, então o valor é sobrescrito.
</P
><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 partir do PHP 4.3.0, o comportamento da geração de índice descrito
acima foi modificado. Agora, se você aumentar um array em que
o maior índice atual for negativo, então a próxima chave
criada será zero (<TT
CLASS="literal"
>0</TT
>). Antes, o novo
índice seria o maior índice existente mais 1,
do mesmo jeito que os índices positivos.
</P
></TD
></TR
></TABLE
></DIV
>
</P
><P
> Note que a chave inteira maior utilizada para isso <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>não
precisa necessariamente existir no array</I
></SPAN
>. Ele pode ter
existido no array desde a última vez que o
array foi indexado. Veja o seguinte exemplo:
</P
><DIV
CLASS="informalexample"
><P
></P
><A
NAME="AEN3300"
></A
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB"><?php<br /></font><font color="#FF8000">// Criando um array normal<br /></font><font color="#0000BB">$array </font><font color="#007700">= 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">);<br /></font><font color="#0000BB">print_r</font><font color="#007700">(</font><font color="#0000BB">$array</font><font color="#007700">);<br /><br /></font><font color="#FF8000">// Agora apagando todos os itens, mas deixando o array intacto:<br /></font><font color="#007700">foreach (</font><font color="#0000BB">$array </font><font color="#007700">as </font><font color="#0000BB">$i </font><font color="#007700">=> </font><font color="#0000BB">$value</font><font color="#007700">) {<br /> unset(</font><font color="#0000BB">$array</font><font color="#007700">[</font><font color="#0000BB">$i</font><font color="#007700">]);<br />}<br /></font><font color="#0000BB">print_r</font><font color="#007700">(</font><font color="#0000BB">$array</font><font color="#007700">);<br /><br /></font><font color="#FF8000">// Acrescentando um item (note que a chabe eh 5, em vez de zero<br />// como voce pode ter esperado).<br /></font><font color="#0000BB">$array</font><font color="#007700">[] = </font><font color="#0000BB">6</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 /><br /></font><font color="#FF8000">// Reindexando:<br /></font><font color="#0000BB">$array </font><font color="#007700">= </font><font color="#0000BB">array_values</font><font color="#007700">(</font><font color="#0000BB">$array</font><font color="#007700">);<br /></font><font color="#0000BB">$array</font><font color="#007700">[] = </font><font color="#0000BB">7</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">?></font>
</font>
</code></TD
></TR
></TABLE
><P
> O exemplo acima deve produzir a seguinte saída:
<TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="screen"
>Array
(
[0] => 1
[1] => 2
[2] => 3
[3] => 4
[4] => 5
)
Array
(
)
Array
(
[5] => 6
)
Array
(
[0] => 6
[1] => 7
)</PRE
></TD
></TR
></TABLE
>
</P
><P
></P
></DIV
></BLOCKQUOTE
></DIV
></DIV
></DIV
><DIV
CLASS="sect2"
><H2
CLASS="sect2"
><A
NAME="language.types.array.useful-funcs"
>Funções úteis</A
></H2
><P
> Há uma série de funções muito úteis para trabalhar com arrays.
Veja a seção sobre <A
HREF="ref.array.html"
>arrays</A
>.
</P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
A função <A
HREF="function.unset.html"
><B
CLASS="function"
>unset()</B
></A
> permite apagar chaves de um
array. Esteja avisado que o array NÃO vai ser reindexado. Se você somente
usa "índices inteiros comuns" (começando do zero, aumentando um a um),
você pode conseguir reindexar o aaray utilizando <A
HREF="function.array-values.html"
><B
CLASS="function"
>array_values()</B
></A
>.
<DIV
CLASS="informalexample"
><P
></P
><A
NAME="AEN3312"
></A
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB"><?php<br />$a </font><font color="#007700">= array( </font><font color="#0000BB">1 </font><font color="#007700">=> </font><font color="#DD0000">'um'</font><font color="#007700">, </font><font color="#0000BB">2 </font><font color="#007700">=> </font><font color="#DD0000">'dois'</font><font color="#007700">, </font><font color="#0000BB">3 </font><font color="#007700">=> </font><font color="#DD0000">'três' </font><font color="#007700">);<br />unset( </font><font color="#0000BB">$a</font><font color="#007700">[</font><font color="#0000BB">2</font><font color="#007700">] );<br /></font><font color="#FF8000">/* irá produzir um array que pode ser definido como<br /> $a = array( 1=>'um', 3=>'três');<br /> e NÃO<br /> $a = array( 1 => 'um', 2 => 'três');<br />*/<br /><br /></font><font color="#0000BB">$b </font><font color="#007700">= </font><font color="#0000BB">array_values</font><font color="#007700">(</font><font color="#0000BB">$a</font><font color="#007700">);<br /></font><font color="#FF8000">// Agora $b eh o array(1 => 'um', 2 =>'três')<br /></font><font color="#0000BB">?></font>
</font>
</code></TD
></TR
></TABLE
><P
></P
></DIV
>
</P
></BLOCKQUOTE
></DIV
><P
> <A
HREF="control-structures.foreach.html"
>foreach</A
>
existe especificamente para lidar com arrays. Ele
provém uma maneira fácil de percorrer qualquer array.
</P
></DIV
><DIV
CLASS="sect2"
><H2
CLASS="sect2"
><A
NAME="language.types.array.donts"
>Array: faça e não faça</A
></H2
><DIV
CLASS="sect3"
><H3
CLASS="sect3"
><A
NAME="language.types.array.foo-bar"
>Porque <TT
CLASS="literal"
>$foo[bar]</TT
> está errado?</A
></H3
><P
> Você sempre deve usar delimitadores em volta um índice
de um array associativo. Por exemplo, utilizar $foo['bar'] e não
$foo[bar]. Mas porque $foo[bar] está errado? Afinal de contas, você vê
essa sintaxe nos scripts antigos:
<DIV
CLASS="informalexample"
><P
></P
><A
NAME="AEN3322"
></A
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB"><?php<br />$foo</font><font color="#007700">[</font><font color="#0000BB">bar</font><font color="#007700">] = </font><font color="#DD0000">'inimigo'</font><font color="#007700">;<br />echo </font><font color="#0000BB">$foo</font><font color="#007700">[</font><font color="#0000BB">bar</font><font color="#007700">];<br /></font><font color="#FF8000">// etc<br /></font><font color="#0000BB">?></font>
</font>
</code></TD
></TR
></TABLE
><P
></P
></DIV
>
Isto está errado, mas funciona. Então, porque está errado? A razão está
neste código, que tem uma constante indefinida (bar) em vez de uma
string ('bar' - repare nos delimitadores), e o PHP pode no futuro definir
constantes que, infelizmente em seu código, podem ter o mesmo
nome. Isto funciona, porque o PHP automaricamente converte uma
<SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>string base</I
></SPAN
> (uma string não delimitada que
não corresponde a nenhum símbolo conhecido) em uma string que contém
a string base. Por exemplo, se não existir uma constante definida com o
nome <TT
CLASS="constant"
><B
>bar</B
></TT
>, então o PHP irá substituí-la pela
string <TT
CLASS="literal"
>'bar'</TT
> e usá-la.
</P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
Isto não significa que você <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>sempre deve</I
></SPAN
> delimitar as
chaves nos arrays. Você não deve delimitar chaves que sejam <A
HREF="language.constants.html"
>constantes</A
> ou <A
HREF="language.variables.html"
>variáveis</A
>, porque isso vai
impedir o PHP de interpretá-las.
</P
><DIV
CLASS="informalexample"
><P
></P
><A
NAME="AEN3332"
></A
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB"><?php<br />error_reporting</font><font color="#007700">(</font><font color="#0000BB">E_ALL</font><font color="#007700">);<br /></font><font color="#0000BB">ini_set</font><font color="#007700">(</font><font color="#DD0000">'display_errors'</font><font color="#007700">, </font><font color="#0000BB">true</font><font color="#007700">);<br /></font><font color="#0000BB">ini_set</font><font color="#007700">(</font><font color="#DD0000">'html_errors'</font><font color="#007700">, </font><font color="#0000BB">false</font><font color="#007700">);<br /></font><font color="#FF8000">// Arrays simples:<br /></font><font color="#0000BB">$array </font><font color="#007700">= array(</font><font color="#0000BB">1</font><font color="#007700">, </font><font color="#0000BB">2</font><font color="#007700">);<br /></font><font color="#0000BB">$count </font><font color="#007700">= </font><font color="#0000BB">count</font><font color="#007700">(</font><font color="#0000BB">$array</font><font color="#007700">);<br />for (</font><font color="#0000BB">$i </font><font color="#007700">= </font><font color="#0000BB">0</font><font color="#007700">; </font><font color="#0000BB">$i </font><font color="#007700">< </font><font color="#0000BB">$count</font><font color="#007700">; </font><font color="#0000BB">$i</font><font color="#007700">++) {<br /> echo </font><font color="#DD0000">"</font><font color="#007700">\n</font><font color="#DD0000">Verificando $i: </font><font color="#007700">\n</font><font color="#DD0000">"</font><font color="#007700">;<br /> echo </font><font color="#DD0000">"Ruim: " </font><font color="#007700">. </font><font color="#0000BB">$array</font><font color="#007700">[</font><font color="#DD0000">'$i'</font><font color="#007700">] . </font><font color="#DD0000">"\n"</font><font color="#007700">;<br /> echo </font><font color="#DD0000">"Bom: " </font><font color="#007700">. </font><font color="#0000BB">$array</font><font color="#007700">[</font><font color="#0000BB">$i</font><font color="#007700">] . </font><font color="#DD0000">"\n"</font><font color="#007700">;<br /> echo </font><font color="#DD0000">"Ruim: </font><font color="#007700">{</font><font color="#DD0000">$array</font><font color="#007700">[</font><font color="#DD0000">'$i'</font><font color="#007700">]}\n</font><font color="#DD0000">"</font><font color="#007700">;<br /> echo </font><font color="#DD0000">"Bom: </font><font color="#007700">{</font><font color="#DD0000">$array</font><font color="#007700">[</font><font color="#DD0000">$i</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
><P
></P
></DIV
><P
><B
>Nota: </B
>
A saída do código acima deve ser:
<TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="screen"
>Verificando 0:
Notice: Undefined index: $i in /path/to/script.html on line 9
Ruim:
Bom: 1
Notice: Undefined index: $i in /path/to/script.html on line 11
Ruim:
Bom: 1
Verificando 1:
Notice: Undefined index: $i in /path/to/script.html on line 9
Ruim:
Bom: 2
Notice: Undefined index: $i in /path/to/script.html on line 11
Ruim:
Bom: 2</PRE
></TD
></TR
></TABLE
>
</P
></BLOCKQUOTE
></DIV
><P
> Mais exemplos para demonstrar esse fato:
<DIV
CLASS="informalexample"
><P
></P
><A
NAME="AEN3337"
></A
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB"><?php<br /></font><font color="#FF8000">// Vamos ver todos os erros<br /></font><font color="#0000BB">error_reporting</font><font color="#007700">(</font><font color="#0000BB">E_ALL</font><font color="#007700">);<br /><br /></font><font color="#0000BB">$arr </font><font color="#007700">= array(</font><font color="#DD0000">'fruta' </font><font color="#007700">=> </font><font color="#DD0000">'maçã'</font><font color="#007700">, </font><font color="#DD0000">'legume' </font><font color="#007700">=> </font><font color="#DD0000">'cenoura'</font><font color="#007700">);<br /><br /></font><font color="#FF8000">// Correto<br /></font><font color="#007700">print </font><font color="#0000BB">$arr</font><font color="#007700">[</font><font color="#DD0000">'fruta'</font><font color="#007700">]; </font><font color="#FF8000">// maçã<br /></font><font color="#007700">print </font><font color="#0000BB">$arr</font><font color="#007700">[</font><font color="#DD0000">'legume'</font><font color="#007700">]; </font><font color="#FF8000">// cenoura<br /><br />// Errado. Isto funciona mas lança um erro PHP do<br />// nível E_NOTICE porque é utilizada uma constante indefinida (fruta)<br />// <br />// Repare: Quando utiliza-se a constrante indefinida fruta, o PHP assume 'fruta'<br /></font><font color="#007700">print </font><font color="#0000BB">$arr</font><font color="#007700">[</font><font color="#0000BB">fruta</font><font color="#007700">]; </font><font color="#FF8000">// maçã<br /><br />// Agora vamos definir uma constante para demonstrar o que pode acontecer. Nós<br />// vamos assimilar o valor 'legume' para a constante de nome fruta<br /></font><font color="#0000BB">define</font><font color="#007700">(</font><font color="#DD0000">'fruta'</font><font color="#007700">, </font><font color="#DD0000">'legume'</font><font color="#007700">);<br /><br /></font><font color="#FF8000">// Observe a diferenca agora<br /></font><font color="#007700">print </font><font color="#0000BB">$arr</font><font color="#007700">[</font><font color="#DD0000">'fruit'</font><font color="#007700">]; </font><font color="#FF8000">// maçã<br /></font><font color="#007700">print </font><font color="#0000BB">$arr</font><font color="#007700">[</font><font color="#0000BB">fruit</font><font color="#007700">]; </font><font color="#FF8000">// cenoura<br /><br />// O exemplo seguinte é normal dentro de uma string. Constantes não são<br />// observadas dentro de strings e por isso nenhum E-NOTICE não é lançado aqui<br /></font><font color="#007700">print </font><font color="#DD0000">"Olá $arr</font><font color="#007700">[</font><font color="#DD0000">fruta</font><font color="#007700">]</font><font color="#DD0000">"</font><font color="#007700">; </font><font color="#FF8000">// Olá maçã<br /><br />// Com uma exceção: chaves envolvendo arrays dentro de strings<br />// ativam a checagem de constantes, como em<br /></font><font color="#007700">print </font><font color="#DD0000">"Olá </font><font color="#007700">{</font><font color="#DD0000">$arr</font><font color="#007700">[</font><font color="#DD0000">fruta</font><font color="#007700">]}</font><font color="#DD0000">"</font><font color="#007700">; </font><font color="#FF8000">// Hello cenoura<br /></font><font color="#007700">print </font><font color="#DD0000">"Olá </font><font color="#007700">{</font><font color="#DD0000">$arr</font><font color="#007700">[</font><font color="#DD0000">'fruta'</font><font color="#007700">]}</font><font color="#DD0000">"</font><font color="#007700">; </font><font color="#FF8000">// Hello maçã<br /><br />// E isso não funciona, resultando em um erro de interpretação do tipo:<br />// Parse error: parse error, expecting T_STRING' or T_VARIABLE' or T_NUM_STRING'<br />// Isso se aplica ao uso de autoglobais em strings<br /></font><font color="#007700">print </font><font color="#DD0000">"Olá $arr</font><font color="#007700">[</font><font color="#DD0000">'fruta'</font><font color="#007700">]</font><font color="#DD0000">"</font><font color="#007700">;<br />print </font><font color="#DD0000">"Olá $_GET</font><font color="#007700">[</font><font color="#DD0000">'foo'</font><font color="#007700">]</font><font color="#DD0000">"</font><font color="#007700">;<br /><br /></font><font color="#FF8000">// Nesse caso, use concatenacao<br /></font><font color="#007700">print </font><font color="#DD0000">"Olá " </font><font color="#007700">. </font><font color="#0000BB">$arr</font><font color="#007700">[</font><font color="#DD0000">'fruta'</font><font color="#007700">]; </font><font color="#FF8000">// Olá maçã<br /></font><font color="#0000BB">?></font>
</font>
</code></TD
></TR
></TABLE
><P
></P
></DIV
>
</P
><P
> Quando você ativa <A
HREF="function.error-reporting.html"
><B
CLASS="function"
>error_reporting()</B
></A
> para mostrar erros de nível
<TT
CLASS="constant"
><B
>E_NOTICE</B
></TT
> (como configurando-a
para <TT
CLASS="constant"
><B
>E_ALL</B
></TT
>) você vê esses
erros. Por padrão, <A
HREF="ref.errorfunc.html#ini.error-reporting"
> error_reporting</A
> esté configurada para não mostrar esse nível de erro.
</P
><P
> Como explicado na seção <A
HREF="language.types.array.html#language.types.array.syntax"
>sintaxe</A
>,
a chave precisa estar entre colchetes
('<TT
CLASS="literal"
>[</TT
>' e '<TT
CLASS="literal"
>]</TT
>'). Isto significa
que você pode escrever coisas como isso:
<DIV
CLASS="informalexample"
><P
></P
><A
NAME="AEN3348"
></A
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB"><?php<br /></font><font color="#007700">echo </font><font color="#0000BB">$arr</font><font color="#007700">[</font><font color="#0000BB">algumafuncao</font><font color="#007700">(</font><font color="#0000BB">$bar</font><font color="#007700">)];<br /></font><font color="#0000BB">?></font>
</font>
</code></TD
></TR
></TABLE
><P
></P
></DIV
>
Isto é um exemplo de utilização de um valor de retorno de função
como um índice de array. O PHP conhece constantes,
como você deve ter visto algumas <TT
CLASS="literal"
>E_*</TT
>
antes.
<DIV
CLASS="informalexample"
><P
></P
><A
NAME="AEN3351"
></A
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB"><?php<br />$error_descriptions</font><font color="#007700">[</font><font color="#0000BB">E_ERROR</font><font color="#007700">] = </font><font color="#DD0000">"Um erro fatal ocorreu"</font><font color="#007700">;<br /></font><font color="#0000BB">$error_descriptions</font><font color="#007700">[</font><font color="#0000BB">E_WARNING</font><font color="#007700">] = </font><font color="#DD0000">"O PHP emitiu um alarme"</font><font color="#007700">;<br /></font><font color="#0000BB">$error_descriptions</font><font color="#007700">[</font><font color="#0000BB">E_NOTICE</font><font color="#007700">] = </font><font color="#DD0000">"Apenas um aviso informal"</font><font color="#007700">;<br /></font><font color="#0000BB">?></font>
</font>
</code></TD
></TR
></TABLE
><P
></P
></DIV
>
Note que <TT
CLASS="literal"
>E_ERROR</TT
> é um identificador válido,
assim como <TT
CLASS="literal"
>bar</TT
> no primeiro exemplo. Mas no último
exemplo seria a mesma coisa que escrevendo:
<DIV
CLASS="informalexample"
><P
></P
><A
NAME="AEN3355"
></A
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB"><?php<br />$error_descriptions</font><font color="#007700">[</font><font color="#0000BB">1</font><font color="#007700">] = </font><font color="#DD0000">"Um erro fatal ocorreu"</font><font color="#007700">;<br /></font><font color="#0000BB">$error_descriptions</font><font color="#007700">[</font><font color="#0000BB">2</font><font color="#007700">] = </font><font color="#DD0000">"O PHP emitiu um alarme"</font><font color="#007700">;<br /></font><font color="#0000BB">$error_descriptions</font><font color="#007700">[</font><font color="#0000BB">8</font><font color="#007700">] = </font><font color="#DD0000">"Apenas um aviso informal"</font><font color="#007700">;<br /></font><font color="#0000BB">?></font>
</font>
</code></TD
></TR
></TABLE
><P
></P
></DIV
>
porque <TT
CLASS="literal"
>E_ERROR</TT
> é igual a <TT
CLASS="literal"
>1</TT
>, e assim por diante.
</P
><P
> Como nós mostramos nos exemplos anteriores,
<TT
CLASS="literal"
>$foo[bar]</TT
> funciona mas está errado.
Funciona porque <TT
CLASS="literal"
>bar</TT
>, na sintaxe onde é utilizada
é esperada como uma expressão constante. Entretanto, nesse caso não
existe constante com o nome <TT
CLASS="literal"
>bar</TT
>. O PHP, hoje,
assume que você quer <TT
CLASS="literal"
>bar</TT
> literalmente,
como a string <TT
CLASS="literal"
>"bar"</TT
>, mas que você esqueceu
de escrever os delimitadores.
</P
><DIV
CLASS="sect4"
><H4
CLASS="sect4"
><A
NAME="AEN3365"
>Então, porque isso é tão mal?</A
></H4
><P
> Se em algum ponto do futuro, o time do PHP quiser acrescentar outra
constante ou palavra chave, ou você mesmo introduzir outra constante na
sua aplicação, você terá problemas. Por exemplo,
se você já não pode utilizar as palavras <TT
CLASS="literal"
>empty</TT
> e
<TT
CLASS="literal"
>default</TT
> dessa maneira, desde que elas são
<A
HREF="reserved.html"
>palavras reservadas especiais</A
>.
</P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
Só para fixar, dentro de uma <A
HREF="language.types.string.html"
><B
CLASS="type"
>string</B
></A
> delimitada por aspas, é
válido não englobar índices de arrays com apóstrofos, de forma que
<TT
CLASS="literal"
>"$foo[bar]"</TT
> é válido. Veja os exemplos
anteriores para detalhes bem como na seção sobre
<A
HREF="language.types.string.html#language.types.string.parsing"
>interpretação de variáveis
em strings</A
>.
</P
></BLOCKQUOTE
></DIV
></DIV
></DIV
></DIV
><DIV
CLASS="sect2"
><H2
CLASS="sect2"
><A
NAME="language.types.array.casting"
>Convertendo para array</A
></H2
><P
> Para qualquer dos tipos: <A
HREF="language.types.integer.html"
><B
CLASS="type"
>integer</B
></A
>, <A
HREF="language.types.float.html"
><B
CLASS="type"
>float</B
></A
>,
<A
HREF="language.types.string.html"
><B
CLASS="type"
>string</B
></A
>, <A
HREF="language.types.boolean.html"
><B
CLASS="type"
>boolean</B
></A
> e <A
HREF="language.types.resource.html"
><B
CLASS="type"
>resource</B
></A
>,
se você converte um valor para um <A
HREF="language.types.array.html"
><B
CLASS="type"
>array</B
></A
>, você obtêm um array
com um elemento (de índice 0) contendo o valor escalar
informado.
</P
><P
> Se você converte um tipo <A
HREF="language.types.object.html"
><B
CLASS="type"
>object</B
></A
> para um array, você obtêm
as propriedades (variáveis membro) do objeto com elementos do array.
As chaves serão o nome das variáveis membro.
</P
><P
> Se você converter um valor <TT
CLASS="constant"
><B
>NULL</B
></TT
> para um array, você terá um array vazio.
</P
></DIV
><DIV
CLASS="sect2"
><H2
CLASS="sect2"
><A
NAME="language.types.array.comparing"
>Comparando</A
></H2
><P
> É possível comparar arrays através de <A
HREF="function.array-diff.html"
><B
CLASS="function"
>array_diff()</B
></A
> e
<A
HREF="language.operators.array.html"
>operadorores de array</A
>.
</P
></DIV
><DIV
CLASS="sect2"
><H2
CLASS="sect2"
><A
NAME="language.types.array.examples"
>Exemplos</A
></H2
><P
> O tipo array do PHP é muito versátil, por isso temos aqui alguns
exemplos para mostrar todo o poder dos arrays.
</P
><P
> <DIV
CLASS="informalexample"
><P
></P
><A
NAME="AEN3398"
></A
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB"><?php<br /></font><font color="#FF8000">// isto<br /></font><font color="#0000BB">$a </font><font color="#007700">= array( </font><font color="#DD0000">'cor' </font><font color="#007700">=> </font><font color="#DD0000">'vermelha'</font><font color="#007700">,<br /> </font><font color="#DD0000">'sabor' </font><font color="#007700">=> </font><font color="#DD0000">'doce'</font><font color="#007700">,<br /> </font><font color="#DD0000">'forma' </font><font color="#007700">=> </font><font color="#DD0000">'redonda'</font><font color="#007700">,<br /> </font><font color="#DD0000">'nome' </font><font color="#007700">=> </font><font color="#DD0000">'maçã'</font><font color="#007700">,<br /> </font><font color="#0000BB">4 </font><font color="#FF8000">// a chave será 0<br /> </font><font color="#007700">);<br /><br /></font><font color="#FF8000">// isto é equivalente a acima<br /></font><font color="#0000BB">$a</font><font color="#007700">[</font><font color="#DD0000">'cor'</font><font color="#007700">] = </font><font color="#DD0000">'vermelha'</font><font color="#007700">;<br /></font><font color="#0000BB">$a</font><font color="#007700">[</font><font color="#DD0000">'sabor'</font><font color="#007700">] = </font><font color="#DD0000">'doce'</font><font color="#007700">;<br /></font><font color="#0000BB">$a</font><font color="#007700">[</font><font color="#DD0000">'forma'</font><font color="#007700">] = </font><font color="#DD0000">'redonda'</font><font color="#007700">;<br /></font><font color="#0000BB">$a</font><font color="#007700">[</font><font color="#DD0000">'nome'</font><font color="#007700">] = </font><font color="#DD0000">'maçã'</font><font color="#007700">;<br /></font><font color="#0000BB">$a</font><font color="#007700">[] = </font><font color="#0000BB">4</font><font color="#007700">; </font><font color="#FF8000">// a chave será 0<br /><br /></font><font color="#0000BB">$b</font><font color="#007700">[] = </font><font color="#DD0000">'a'</font><font color="#007700">;<br /></font><font color="#0000BB">$b</font><font color="#007700">[] = </font><font color="#DD0000">'b'</font><font color="#007700">;<br /></font><font color="#0000BB">$b</font><font color="#007700">[] = </font><font color="#DD0000">'c'</font><font color="#007700">;<br /></font><font color="#FF8000">// o mesmo de array( 0 => 'a' , 1 => 'b' , 2 => 'c' ),<br />// ou simplesmente array('a', 'b', 'c')<br /></font><font color="#0000BB">?></font>
</font>
</code></TD
></TR
></TABLE
><P
></P
></DIV
>
</P
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN3400"
></A
><P
><B
>Exemplo 11-4. Utilizando array()</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB"><?php<br /></font><font color="#FF8000">// Array como (propriedade-)mapa<br /></font><font color="#0000BB">$map </font><font color="#007700">= array( </font><font color="#DD0000">'versao' </font><font color="#007700">=> </font><font color="#0000BB">4</font><font color="#007700">,<br /> </font><font color="#DD0000">'OS' </font><font color="#007700">=> </font><font color="#DD0000">'Linux'</font><font color="#007700">,<br /> </font><font color="#DD0000">'lang' </font><font color="#007700">=> </font><font color="#DD0000">'inglês'</font><font color="#007700">,<br /> </font><font color="#DD0000">'short_tags' </font><font color="#007700">=> </font><font color="#0000BB">true<br /> </font><font color="#007700">);<br /><br /></font><font color="#FF8000">// apenas chaves numéricas<br /></font><font color="#0000BB">$array </font><font color="#007700">= array( </font><font color="#0000BB">7</font><font color="#007700">,<br /> </font><font color="#0000BB">8</font><font color="#007700">,<br /> </font><font color="#0000BB">0</font><font color="#007700">,<br /> </font><font color="#0000BB">156</font><font color="#007700">,<br /> -</font><font color="#0000BB">10<br /> </font><font color="#007700">);<br /></font><font color="#FF8000">// que é o mesmo que array( 0 => 7, 1 => 8, ...)<br /><br /></font><font color="#0000BB">$switching </font><font color="#007700">= array( </font><font color="#0000BB">10</font><font color="#007700">, </font><font color="#FF8000">// chave = 0<br /> </font><font color="#0000BB">5 </font><font color="#007700">=> </font><font color="#0000BB">6</font><font color="#007700">,<br /> </font><font color="#0000BB">3 </font><font color="#007700">=> </font><font color="#0000BB">7</font><font color="#007700">,<br /> </font><font color="#DD0000">'a' </font><font color="#007700">=> </font><font color="#0000BB">4</font><font color="#007700">,<br /> </font><font color="#0000BB">11</font><font color="#007700">, </font><font color="#FF8000">// chave = 6 (o índice máximo era 5)<br /> </font><font color="#DD0000">'8' </font><font color="#007700">=> </font><font color="#0000BB">2</font><font color="#007700">, </font><font color="#FF8000">// chave = 8 (inteiro!)<br /> </font><font color="#DD0000">'02' </font><font color="#007700">=> </font><font color="#0000BB">77</font><font color="#007700">, </font><font color="#FF8000">// chave = '02'<br /> </font><font color="#0000BB">0 </font><font color="#007700">=> </font><font color="#0000BB">12 </font><font color="#FF8000">// o valor 10 será sobrescrito por 12<br /> </font><font color="#007700">);<br /><br /></font><font color="#FF8000">// array vazio<br /></font><font color="#0000BB">$empty </font><font color="#007700">= array();<br /></font><font color="#0000BB">?></font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="language.types.array.examples.loop"
></A
><P
><B
>Exemplo 11-5. Coleção</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB"><?php<br />$cores </font><font color="#007700">= array(</font><font color="#DD0000">'vermelho'</font><font color="#007700">, </font><font color="#DD0000">'azul'</font><font color="#007700">, </font><font color="#DD0000">'verde'</font><font color="#007700">, </font><font color="#DD0000">'amarelo'</font><font color="#007700">);<br /><br />foreach (</font><font color="#0000BB">$cores </font><font color="#007700">as </font><font color="#0000BB">$cor</font><font color="#007700">) {<br /> echo </font><font color="#DD0000">"Você gosta de $cor?</font><font color="#007700">\n</font><font color="#DD0000">"</font><font color="#007700">;<br />}<br /><br /></font><font color="#FF8000">/* saida:<br />Você gosta de vermelho?<br />Você gosta de azul?<br />Você gosta de verde?<br />Você gosta de amarelo?<br />*/<br /></font><font color="#0000BB">?></font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
><P
> Note que atualmente não se pode mudar os valores de um array
diretamente dentro de um loop.
Superar essa limitação é possível da seguinte forma:
<TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="language.types.array.examples.changeloop"
></A
><P
><B
>Exemplo 11-6. Coleção</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB"><?php<br /></font><font color="#007700">foreach (</font><font color="#0000BB">$cores </font><font color="#007700">as </font><font color="#0000BB">$key </font><font color="#007700">=> </font><font color="#0000BB">$cor</font><font color="#007700">) {<br /> </font><font color="#FF8000">// não funciona:<br /> //$cor = strtoupper($cor);<br /><br /> //funciona:<br /> </font><font color="#0000BB">$cores</font><font color="#007700">[</font><font color="#0000BB">$key</font><font color="#007700">] = </font><font color="#0000BB">strtoupper</font><font color="#007700">(</font><font color="#0000BB">$cor</font><font color="#007700">);<br />}<br /></font><font color="#0000BB">print_r</font><font color="#007700">(</font><font color="#0000BB">$cores</font><font color="#007700">);<br /><br /></font><font color="#FF8000">/* saida:<br />Array<br />(<br /> [0] => VERMELHO<br /> [1] => AZUL<br /> [2] => VERDE<br /> [3] => AMARELO<br />)<br />*/<br /></font><font color="#0000BB">?></font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
</P
><P
> Este exemplo cria um array na base 1.
<TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN3411"
></A
><P
><B
>Exemplo 11-7. Array baseado em 1</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB"><?php<br />$primeiroquarto </font><font color="#007700">= array(</font><font color="#0000BB">1 </font><font color="#007700">=> </font><font color="#DD0000">'Janeiro'</font><font color="#007700">, </font><font color="#DD0000">'Fevereiro'</font><font color="#007700">, </font><font color="#DD0000">'Março'</font><font color="#007700">);<br /></font><font color="#0000BB">print_r</font><font color="#007700">(</font><font color="#0000BB">$primeiroquarto</font><font color="#007700">);<br /><br /></font><font color="#FF8000">/* saida:<br />Array<br />(<br /> [1] => 'Janeiro'<br /> [2] => 'Fevereiro'<br /> [3] => 'Março'<br />)<br />*/<br /></font><font color="#0000BB">?></font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
</P
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN3414"
></A
><P
><B
>Exemplo 11-8. Preenchendo um array real</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB"><?php<br /></font><font color="#FF8000">// preenchendo um array com todos os itens de um diretório<br /></font><font color="#0000BB">$handle </font><font color="#007700">= </font><font color="#0000BB">opendir</font><font color="#007700">(</font><font color="#DD0000">'.'</font><font color="#007700">);<br />while (</font><font color="#0000BB">false </font><font color="#007700">!== (</font><font color="#0000BB">$file </font><font color="#007700">= </font><font color="#0000BB">readdir</font><font color="#007700">(</font><font color="#0000BB">$handle</font><font color="#007700">))) {<br /> </font><font color="#0000BB">$files</font><font color="#007700">[] = </font><font color="#0000BB">$file</font><font color="#007700">;<br />}<br /></font><font color="#0000BB">closedir</font><font color="#007700">(</font><font color="#0000BB">$handle</font><font color="#007700">); <br /></font><font color="#0000BB">?></font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
><P
> Arrays são ordenados. Você pode mudar sua ordem utilizando vários
funções de ordenação. Veja as <A
HREF="ref.array.html"
>funções
de arrays</A
> para mais informações. Você pode contar
o número de itens de um array com a função
<A
HREF="function.count.html"
><B
CLASS="function"
>count()</B
></A
>.
</P
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN3420"
></A
><P
><B
>Exemplo 11-9. Ordenando arrays</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB"><?php<br />sort</font><font color="#007700">(</font><font color="#0000BB">$files</font><font color="#007700">);<br /></font><font color="#0000BB">print_r</font><font color="#007700">(</font><font color="#0000BB">$files</font><font color="#007700">);<br /></font><font color="#0000BB">?></font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
><P
> Porque o valor de um array pode ser qualquer coisa, isto pode ser
outro array. Isto pode criar arrays recursivos e
multidimensionais.
</P
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN3424"
></A
><P
><B
>Exemplo 11-10. Arrays recursivos e multidimensionais</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB"><?php<br />$fruits </font><font color="#007700">= array ( </font><font color="#DD0000">"frutas" </font><font color="#007700">=> array ( </font><font color="#DD0000">"a" </font><font color="#007700">=> </font><font color="#DD0000">"laranja"</font><font color="#007700">,<br /> </font><font color="#DD0000">"b" </font><font color="#007700">=> </font><font color="#DD0000">"banana"</font><font color="#007700">,<br /> </font><font color="#DD0000">"c" </font><font color="#007700">=> </font><font color="#DD0000">"maçã"</font><font color="#007700">,<br /> ),<br /> </font><font color="#DD0000">"numeros" </font><font color="#007700">=> array ( </font><font color="#0000BB">1</font><font color="#007700">,<br /> </font><font color="#0000BB">2</font><font color="#007700">,<br /> </font><font color="#0000BB">3</font><font color="#007700">,<br /> </font><font color="#0000BB">4</font><font color="#007700">,<br /> </font><font color="#0000BB">5</font><font color="#007700">,<br /> </font><font color="#0000BB">6<br /> </font><font color="#007700">),<br /> </font><font color="#DD0000">"buracos" </font><font color="#007700">=> array ( </font><font color="#DD0000">"primeiro"</font><font color="#007700">,<br /> </font><font color="#0000BB">5 </font><font color="#007700">=> </font><font color="#DD0000">"segundo"</font><font color="#007700">,<br /> </font><font color="#DD0000">"terceiro"</font><font color="#007700">,<br /> ),<br /> );<br /><br /></font><font color="#FF8000">// Alguns exemplo de enderecos dos valores do array acima<br /></font><font color="#007700">echo </font><font color="#0000BB">$fruits</font><font color="#007700">[</font><font color="#DD0000">"buracos"</font><font color="#007700">][</font><font color="#0000BB">5</font><font color="#007700">]; </font><font color="#FF8000">// prints "segundo"<br /></font><font color="#007700">echo </font><font color="#0000BB">$fruits</font><font color="#007700">[</font><font color="#DD0000">"frutas"</font><font color="#007700">][</font><font color="#DD0000">"a"</font><font color="#007700">]; </font><font color="#FF8000">// prints "laranja"<br /></font><font color="#007700">unset(</font><font color="#0000BB">$fruits</font><font color="#007700">[</font><font color="#DD0000">"buracos"</font><font color="#007700">][</font><font color="#0000BB">0</font><font color="#007700">]); </font><font color="#FF8000">// remove "primeiro"<br /><br />// Criando um novo array multidimensional<br /></font><font color="#0000BB">$sucos</font><font color="#007700">[</font><font color="#DD0000">"maca"</font><font color="#007700">][</font><font color="#DD0000">"verde"</font><font color="#007700">] = </font><font color="#DD0000">"bom"</font><font color="#007700">;<br /></font><font color="#0000BB">?></font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
><P
> Você precisa estar ciente que a atribuição sempre envolve
cópia de valor. Você precisa utilizar o operadore de referência para
copiar um array por referência.
<DIV
CLASS="informalexample"
><P
></P
><A
NAME="AEN3428"
></A
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB"><?php<br />$arr1 </font><font color="#007700">= array(</font><font color="#0000BB">2</font><font color="#007700">, </font><font color="#0000BB">3</font><font color="#007700">);<br /></font><font color="#0000BB">$arr2 </font><font color="#007700">= </font><font color="#0000BB">$arr1</font><font color="#007700">;<br /></font><font color="#0000BB">$arr2</font><font color="#007700">[] = </font><font color="#0000BB">4</font><font color="#007700">; </font><font color="#FF8000">// $arr2 eh modificado,<br /> // $arr1 continua sendo apenas array(2, 3)<br /><br /></font><font color="#0000BB">$arr3 </font><font color="#007700">= &</font><font color="#0000BB">$arr1</font><font color="#007700">;<br /></font><font color="#0000BB">$arr3</font><font color="#007700">[] = </font><font color="#0000BB">4</font><font color="#007700">; </font><font color="#FF8000">// agora $arr1 e $arr3 sao os mesmos<br /></font><font color="#0000BB">?></font>
</font>
</code></TD
></TR
></TABLE
><P
></P
></DIV
>
</P
></DIV
></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="language.types.string.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="language.types.object.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Strings</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="language.types.html"
ACCESSKEY="U"
>Acima</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Objetos</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
