Reduz o deque a um único valor usando uma função de retorno de chamada

Descrição

public Ds\Deque::reduce(callable $callback, mixed $initial = ?): mixed

Reduz o deque a um único valor usando uma função de retorno de chamada.

Parâmetros

callback

callback(mixed $carry, mixed $value): mixed

carry: O valor de retorno da chamada de retorno anterior ou initial se for a primeira iteração.
value: O valor da iteração atual.

initial

O valor inicial do valor de retorno. Pode ser null.

Valor Retornado

O valor de retorno da chamada de retorno final.

Exemplos

Example #1 Exemplo de Ds\Deque::reduce() com valor inicial

<?php
$deque = new \Ds\Deque([1, 2, 3]);

$callback = function($carry, $value) {
    return $carry * $value;
};

var_dump($deque->reduce($callback, 5));

// Iterations:
//
// $carry = $initial = 5
//
// $carry = $carry * 1 =  5
// $carry = $carry * 2 = 10
// $carry = $carry * 3 = 30
?>

O exemplo acima produzirá algo semelhante a:

int(30)

Example #2 Exemplo de Ds\Deque::reduce() sem um valor inicial

<?php
$deque = new \Ds\Deque([1, 2, 3]);

var_dump($deque->reduce(function($carry, $value) {
    return $carry + $value + 5;
}));

// Iterations:
//
// $carry = $initial = null
//
// $carry = $carry + 1 + 5 =  6
// $carry = $carry + 2 + 5 = 13
// $carry = $carry + 3 + 5 = 21
?>

O exemplo acima produzirá algo semelhante a:

int(21)