iterator_apply

(PHP 5 >= 5.1.0, PHP 7)

iterator_apply — ユーザー関数をイテレータのすべての要素でコールする

説明

iterator_apply ( Traversable $iterator , callable $function [, array $args ] ) : int

イテレータ内のすべての要素に対して関数をコールします。

パラメータ

iterator

順次処理したいクラス。

function

すべての要素に対してコールしたいコールバック関数。

注意: iterator での処理を続けるために、 この関数は TRUE を返さなければなりません。

args

コールバック関数に渡す引数。

返り値

イテレータの要素数を返します。

例

例1 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));
?>

上の例の出力は以下となります。

APPLES
BANANAS
CHERRIES

参考

  • array_walk() - 配列の全ての要素にユーザー定義の関数を適用する