Knowledge baseExam Center
ENEnglish
Choose language13

CKTIS / PHP

CallbackFilterIterator

Filter an Iterator lazily by invoking a callback with the current value, key and inner iterator.

Version: PHP 8.4; repository runtime, production runtime not attested

Syntax

new CallbackFilterIterator($iterator, $callback)

Filter an Iterator lazily by invoking a callback with the current value, key and inner iterator. A truthy callback result keeps the original item and key without transforming it. Constructing the wrapper does not call the filter until traversal begins.

$calls=0;
$it=new CallbackFilterIterator(new ArrayIterator(["a"=>1,"b"=>4,"c"=>2]),function($v,$k,$inner)use(&$calls){++$calls;return $v>=2 && $k!=="c" && $inner->valid();});
$before=$calls; $kept=iterator_to_array($it); echo json_encode([$before,$kept,$calls]);
[0,{"b":4},3]

Examples

<?php
$calls=0;
$it=new CallbackFilterIterator(new ArrayIterator(["a"=>1,"b"=>4,"c"=>2]),function($v,$k,$inner)use(&$calls){++$calls;return $v>=2 && $k!=="c" && $inner->valid();});
$before=$calls; $kept=iterator_to_array($it); echo json_encode([$before,$kept,$calls]);

Result

[0,{"b":4},3]

Sources