Ds\Sequence::reduce
En esta página
Ds\Sequence::reduce
Reduce la secuencia a un solo valor utilizando una función de retrollamada
Descripción#
abstract public Ds\Sequence::reduce(callable $callback, [mixed $initial]): mixed
```php
Reduce la secuencia a un solo valor utilizando una función de retrollamada.
## Parámetros
`callback`
```php
callback(mixed $carry, mixed $value): mixed
carry
El valor de retorno de la retrollamada anterior, o initial si es la primera iteración.
value
El valor de la iteración actual.
initial
El valor inicial del valor de retorno. Puede ser null.
Valores devueltos#
El valor de retorno de la retrollamada final.
Ejemplos#
Ejemplo de Ds\Sequence::reduce con un valor inicial
<?php
$sequence = new \Ds\Vector([1, 2, 3]);
$callback = function($carry, $value) {
return $carry * $value;
};
var_dump($sequence->reduce($callback, 5));
// Iteraciones:
//
// $carry = $initial = 5
//
// $carry = $carry * 1 = 5
// $carry = $carry * 2 = 10
// $carry = $carry * 3 = 30
?>
Resultado del ejemplo anterior es similar a:
int(30)
Ejemplo de Ds\Sequence::reduce sin valor inicial
<?php
$sequence = new \Ds\Vector([1, 2, 3]);
var_dump($sequence->reduce(function($carry, $value) {
return $carry + $value + 5;
}));
// Iteraciones:
//
// $carry = $initial = null
//
// $carry = $carry + 1 + 5 = 6
// $carry = $carry + 2 + 5 = 13
// $carry = $carry + 3 + 5 = 21
?>
Resultado del ejemplo anterior es similar a:
int(21)