array_walk_recursive

(PHP 5, PHP 7, PHP 8)

array_walk_recursive — Aplica um função do usuário recursivamente para cada membro de um array

Descrição

array_walk_recursive(array|object&$array, callable$callback, mixed$arg = null): bool

Aplica a função callback definida pelo usuário para cada elemento do array array. Esta função irá recursar em arrays mais profundos.

Parâmetros

array: O array de entrada.
callback: Tipicamente, callback usa dois parâmetros. O valor do parâmetro array sendo o primeiro, e a chave/índice o segundo.
Nota:
Se callback precisa trabalhar com atuais valores da array, especifique o primeiro parâmetro da callback com uma referência. Então, as modificações feitas para estes elementos serão feitas no próprio array original.
arg: Se o parâmetro opcional arg for fornecido, ele será passado como o terceiro parâmetro para o callback.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Exemplos

Exemplo #1 Exemplo da array_walk_recursive()

<?php
$doce = array('a' => 'maça', 'b' => 'banana');
$frutas = array('doce' => $doce, 'azedo' => 'limão');

function test_print($item, $chave)
{
 echo "$chave contém $item\n";
}

array_walk_recursive($frutas, 'test_print');
?>

O exemplo acima produzirá:

a contém maça b contém banana azedo contém limão

Você pode notar que a chave 'doce' nunca é exibida. Qualquer chave que contém um array não será passada para a função.

Veja Também

array_walk() - Aplica uma determinada função em cada elemento de um array