(PHP 4 >= 4.0.5, PHP 5, PHP 7)
array_reduce — Reduz um array para um único valor através de um processo iterativo via função callback
array_reduce() aplica iterativamente a função
callback
aos elementos de
array
, de forma a reduzir o array a
um único valor.
array
O array de entrada.
callback
carry
Informa o valor da iteração anterior. No caso da
primeira iteração ele terá o valor de
initial
.
item
Mantém o valor da iteração atual.
initial
Se o argumento opcional initial
for passado, ele será utilizado no início do processo, ou como
um resultado final se o array estiver vazio.
Retorna o valor resultante.
Se a array estiver vazio e initial
não for passado,
array_reduce() retornará NULL
.
Versão | Descrição |
---|---|
5.3.0 |
initial modificado para permitir mixed (anteriormente era integer).
|
Exemplo #1 Exemplo de array_reduce()
<?php
function sum($carry, $item)
{
$carry += $item;
return $carry;
}
function product($carry, $item)
{
$carry *= $item;
return $carry;
}
$a = array(1, 2, 3, 4, 5);
$x = array();
var_dump(array_reduce($a, "sum")); // int(15)
var_dump(array_reduce($a, "product", 10)); // int(1200), because: 10*1*2*3*4*5
var_dump(array_reduce($x, "sum", "No data to reduce")); // string(17) "No data to reduce"
?>