array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.array-reduce.php', 1 => 'array_reduce', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Funções para Array', ), 'prev' => array ( 0 => 'function.array-rand.php', 1 => 'array_rand', ), 'next' => array ( 0 => 'function.array-replace-recursive.php', 1 => 'array_replace_recursive', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/array/functions/array-reduce.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
array_reduce — Reduz um array para um único valor através de um processo iterativo via 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 |
---|---|
8.0.0 |
Se a função callback espera que um parâmetro seja passado
por referência, esta função agora emitirá um E_WARNING .
|
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"
?>