iterator_apply

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

iterator_apply — Chama uma função para cada elemento em um iterador

Descrição

iterator_apply(Traversable $iterator, callable $callback, ?array $args = null): int

Chama uma função para cada elemento em um iterador.

Parâmetros

iterator: O objeto iterador sobre o qual iterar.
callback: A função callback para chamar em cada elemento. Esta função recebe apenas os args dados, então é nulária por padrão. Se count($args) === 3, por exemplo, a função callback é ternária.
Note: A função deve retornar true para continuar iterando sobre o iterator.
args: Um array de argumentos; cada elemento de args é passado para a função callback callback como um argumento separado.

Valor Retornado

Retorna a contagem de iteração.

Exemplos

Example #1 Exemplo de iterator_apply()

<?php
function print_caps(Iterator $iterator) {
    echo strtoupper($iterator->current()) . "\n";
    return TRUE;
}

$it = new ArrayIterator(array("Apples", "Bananas", "Cherries"));
iterator_apply($it, "print_caps", array($it));
?>

O exemplo acima produzirá:

APPLES
BANANAS
CHERRIES

Veja Também

array_walk() - Aplica uma determinada função em cada elemento de um array