|
1 | 1 | <?xml version="1.0" encoding="utf-8"?> |
2 | | -<!-- EN-Revision: cec5275f23d2db648df30a5702b378044431be97 Maintainer: ae Status: ready --><!-- CREDITS: felipe,lucasr,cautnew,ae,leonardolara --> |
| 2 | +<!-- EN-Revision: 4ca7cdeaee66bff2fefb9df88213ea6fc2e6f3dc Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe,lucasr,cautnew,ae,leonardolara --> |
3 | 3 | <refentry xml:id="function.array-walk" xmlns="http://docbook.org/ns/docbook"> |
4 | 4 | <refnamediv> |
5 | 5 | <refname>array_walk</refname> |
|
15 | 15 | </methodsynopsis> |
16 | 16 | <simpara> |
17 | 17 | Aplica uma função definida pelo usuário passada pelo argumento |
18 | | - <parameter>callback</parameter> em cada elemento de <parameter>array</parameter>. |
| 18 | + <parameter>callback</parameter> em cada elemento do <parameter>array</parameter>. |
19 | 19 | </simpara> |
20 | 20 | <para> |
21 | | - <function>array_walk</function> não é afetado pelo ponteiro interno de |
22 | | - <parameter>array</parameter>. <function>array_walk</function> |
23 | | - percorrerá por todo array desconsiderando a posição do ponteiro. |
| 21 | + <function>array_walk</function> não é afetado pelo ponteiro interno do |
| 22 | + <parameter>array</parameter>. <function>array_walk</function> |
| 23 | + percorrerá todo o array desconsiderando a posição do ponteiro. |
24 | 24 | </para> |
25 | 25 | </refsect1> |
26 | 26 | <refsect1 role="parameters"> |
|
39 | 39 | <term><parameter>callback</parameter></term> |
40 | 40 | <listitem> |
41 | 41 | <para> |
42 | | - Normalmente, o <parameter>callback</parameter> recebe dois parâmetros. |
43 | | - O valor do parâmetro <parameter>array</parameter> sendo o primeiro, e |
44 | | - a chave/índice o segundo. |
| 42 | + Normalmente, <parameter>callback</parameter> recebe dois parâmetros. |
| 43 | + O valor do parâmetro <parameter>array</parameter> é o primeiro e |
| 44 | + a chave/índice é o segundo. |
45 | 45 | </para> |
46 | 46 | <note> |
47 | 47 | <para> |
48 | | - Se <parameter>callback</parameter> precisar alterar realmente os valores |
| 48 | + Se <parameter>callback</parameter> realmente precisar alterar os valores |
49 | 49 | do array, especifique que o primeiro parâmetro de |
50 | 50 | <parameter>callback</parameter> deve ser passado por |
51 | | - <link linkend="language.references">referência</link>. Então |
| 51 | + <link linkend="language.references">referência</link>. Assim, |
52 | 52 | qualquer mudança feita nesses elementos serão feitas |
53 | 53 | no próprio array também. |
54 | 54 | </para> |
55 | 55 | </note> |
56 | 56 | <note> |
57 | | - <para> |
58 | | - Muitas funções internas (por exemplo <function>strtolower</function>) |
59 | | - lançarão um alerta se forem passados mais argumentos |
60 | | - que o esperado e não forem utilizados diretamente no |
61 | | - <parameter>callback</parameter>. |
62 | | - </para> |
| 57 | + <para> |
| 58 | + Muitas funções internas (por exemplo <function>strtolower</function>) |
| 59 | + lançarão uma exceção se forem passados mais argumentos |
| 60 | + que o esperado e não forem utilizados diretamente na função |
| 61 | + <parameter>callback</parameter>. |
| 62 | + </para> |
63 | 63 | </note> |
64 | 64 | <para> |
65 | 65 | Apenas os valores de um <parameter>array</parameter> podem potencialmente |
66 | 66 | ser alterados; sua estrutura não pode ser alterada, por exemplo, o programador não pode |
67 | | - adicionar, remover ou reordenar elementos. Se o callback não respeitar esta regra, |
| 67 | + adicionar, remover ou reordenar elementos. Se a função não respeitar esta regra, |
68 | 68 | o comportamento desta função é indefinido e |
69 | 69 | imprevisível. |
70 | 70 | </para> |
|
74 | 74 | <term><parameter>arg</parameter></term> |
75 | 75 | <listitem> |
76 | 76 | <para> |
77 | | - Se o parâmetro opcional <parameter>arg</parameter> é fornecido, |
78 | | - será passado como o terceiro parâmetro para o callback |
| 77 | + Se o parâmetro opcional <parameter>arg</parameter> for fornecido, |
| 78 | + será passado como o terceiro parâmetro para a função |
79 | 79 | <parameter>callback</parameter>. |
80 | 80 | </para> |
81 | 81 | </listitem> |
|
98 | 98 | ou se mais de 3 argumentos no caso de <parameter>arg</parameter> ser informado. |
99 | 99 | Anteriormente, nesses casos |
100 | 100 | um erro de nível <link linkend="errorfunc.constants">E_WARNING</link> seria gerado em cada vez que |
101 | | - <function>array_walk</function> chamasse o <parameter>callback</parameter>. |
| 101 | + <function>array_walk</function> chamasse a função <parameter>callback</parameter>. |
102 | 102 | </para> |
103 | 103 | </refsect1> |
104 | 104 |
|
|
130 | 130 | &reftitle.examples; |
131 | 131 | <para> |
132 | 132 | <example> |
133 | | - <title>Exemplo da <function>array_walk</function></title> |
| 133 | + <title>Exemplo de <function>array_walk</function></title> |
134 | 134 | <programlisting role="php"> |
135 | 135 | <![CDATA[ |
136 | 136 | <?php |
|
0 commit comments