iterator_apply

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

iterator_applyLlama a una función para todos los elementos de un iterador

Descripción

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

Llama a una función para todos los elementos de un iterador.

Parámetros

iterator

El objeto iterador a iterar.

callback

La función de devolución de llamada a invocar para cada elemento. Esta función solo recibe los argumentos args proporcionados, por lo que es nullaria por defecto. Si count($args) === 3, por ejemplo, la función es ternaria.

Nota: La función debe devolver true para continuar iterando a través del iterador nombrado por el parámetro iterator.

args

Un array array de argumentos; cada elemento de args se pasa a la función de devolución de llamada callback como argumento separado.

Valores devueltos

Devuelve el número de iteraciones.

Ejemplos

Ejemplo #1 Ejemplo con 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));
?>

El resultado del ejemplo sería:

APPLES
BANANAS
CHERRIES

Ver también

  • array_walk() - Ejecuta una función proporcionada por el usuario en cada uno de los elementos de un array