array_reduce
(PHP 4 >= 4.0.5, PHP 5)
array_reduce — Reduce iterativamente un array a un solo valor usando una función llamada de retorno
Descripción
array_reduce() aplica iterativamente la función
callback a los elementos de
array, con el propósito de reducir el array a
un solo valor.
Parámetros
-
array -
El array de entrada.
-
callback -
-
carry -
Conserva el valor de retorno de la iteración anterior; en el caso de que sea la primera iteración, conservará el valor de
initial. -
item -
Conserva el valor de la iteración actual.
-
-
initial -
Si el parámetro opcional
initialestá disponible, será usado al comienzo del proceso, o como un resultado final en caso de que el array esté vacío.
Valores devueltos
Devuelve el valor resultante.
Si el array está vacío y no se proporciona el parámetro initial,
array_reduce() devuelve NULL.
Historial de cambios
| Versión | Descripción |
|---|---|
| 5.3.0 |
Se cambió el parámetro initial para permitir mixed, anteriormente era integer.
|
Ejemplos
Ejemplo #1 Ejemplo de array_reduce()
<?php
function suma($carry, $item)
{
$carry += $item;
return $carry;
}
function multiplicación($carry, $item)
{
$carry *= $item;
return $carry;
}
$a = array(1, 2, 3, 4, 5);
$x = array();
var_dump(array_reduce($a, "suma")); // int(15)
var_dump(array_reduce($a, "multiplicación", 10)); // int(1200), ya que: 10*1*2*3*4*5
var_dump(array_reduce($x, "suma", "No hay datos a reducir")); // string(22) "No hay datos a reducir"
?>
Ver también
- array_filter() - Filtra elementos de un array usando una función de devolución de llamada
- array_map() - Aplica la retrollamada especificada a los elementos de cada array
- array_unique() - Elimina valores duplicados de un array
- array_count_values() - Cuenta todos los valores de un array