sync with en rev

This commit is contained in:
Leonardo Lara Rodrigues
2025-10-30 11:17:46 -03:00
parent 2e303e4f17
commit 4634ba4ff9

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cec5275f23d2db648df30a5702b378044431be97 Maintainer: ae Status: ready --><!-- CREDITS: felipe,lucasr,cautnew,ae,leonardolara -->
<!-- EN-Revision: 4ca7cdeaee66bff2fefb9df88213ea6fc2e6f3dc Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe,lucasr,cautnew,ae,leonardolara -->
<refentry xml:id="function.array-walk" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>array_walk</refname>
@@ -15,12 +15,12 @@
</methodsynopsis>
<simpara>
Aplica uma função definida pelo usuário passada pelo argumento
<parameter>callback</parameter> em cada elemento de <parameter>array</parameter>.
<parameter>callback</parameter> em cada elemento do <parameter>array</parameter>.
</simpara>
<para>
<function>array_walk</function> não é afetado pelo ponteiro interno de
<parameter>array</parameter>. <function>array_walk</function>
percorrerá por todo array desconsiderando a posição do ponteiro.
<function>array_walk</function> não é afetado pelo ponteiro interno do
<parameter>array</parameter>. <function>array_walk</function>
percorrerá todo o array desconsiderando a posição do ponteiro.
</para>
</refsect1>
<refsect1 role="parameters">
@@ -39,32 +39,32 @@
<term><parameter>callback</parameter></term>
<listitem>
<para>
Normalmente, o <parameter>callback</parameter> recebe dois parâmetros.
O valor do parâmetro <parameter>array</parameter> sendo o primeiro, e
a chave/índice o segundo.
Normalmente, <parameter>callback</parameter> recebe dois parâmetros.
O valor do parâmetro <parameter>array</parameter> é o primeiro e
a chave/índice é o segundo.
</para>
<note>
<para>
Se <parameter>callback</parameter> precisar alterar realmente os valores
Se <parameter>callback</parameter> realmente precisar alterar os valores
do array, especifique que o primeiro parâmetro de
<parameter>callback</parameter> deve ser passado por
<link linkend="language.references">referência</link>. Então
<link linkend="language.references">referência</link>. Assim,
qualquer mudança feita nesses elementos serão feitas
no próprio array também.
</para>
</note>
<note>
<para>
Muitas funções internas (por exemplo <function>strtolower</function>)
lançarão um alerta se forem passados mais argumentos
que o esperado e não forem utilizados diretamente no
<parameter>callback</parameter>.
</para>
<para>
Muitas funções internas (por exemplo <function>strtolower</function>)
lançarão uma exceção se forem passados mais argumentos
que o esperado e não forem utilizados diretamente na função
<parameter>callback</parameter>.
</para>
</note>
<para>
Apenas os valores de um <parameter>array</parameter> podem potencialmente
ser alterados; sua estrutura não pode ser alterada, por exemplo, o programador não pode
adicionar, remover ou reordenar elementos. Se o callback não respeitar esta regra,
adicionar, remover ou reordenar elementos. Se a função não respeitar esta regra,
o comportamento desta função é indefinido e
imprevisível.
</para>
@@ -74,8 +74,8 @@
<term><parameter>arg</parameter></term>
<listitem>
<para>
Se o parâmetro opcional <parameter>arg</parameter> é fornecido,
será passado como o terceiro parâmetro para o callback
Se o parâmetro opcional <parameter>arg</parameter> for fornecido,
será passado como o terceiro parâmetro para a função
<parameter>callback</parameter>.
</para>
</listitem>
@@ -98,7 +98,7 @@
ou se mais de 3 argumentos no caso de <parameter>arg</parameter> ser informado.
Anteriormente, nesses casos
um erro de nível <link linkend="errorfunc.constants">E_WARNING</link> seria gerado em cada vez que
<function>array_walk</function> chamasse o <parameter>callback</parameter>.
<function>array_walk</function> chamasse a função <parameter>callback</parameter>.
</para>
</refsect1>
@@ -130,7 +130,7 @@
&reftitle.examples;
<para>
<example>
<title>Exemplo da <function>array_walk</function></title>
<title>Exemplo de <function>array_walk</function></title>
<programlisting role="php">
<![CDATA[
<?php