Knowledge baseExam Center
ENEnglish
Choose language13

CKTIS / PHP

Traversable

Accept objects with iterator behavior through this marker interface.

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

Syntax

function collect(Traversable $items): array

Accept objects with iterator behavior through this marker interface. Since PHP 8 an abstract user class can implement the marker directly. A concrete class must provide Iterator or IteratorAggregate. Arrays satisfy iterable but are not Traversable objects. If both forms should be accepted use the iterable type.

function collect(Traversable $items): array {return iterator_to_array($items,false);}
$cursor=new ArrayIterator([2,4]); echo json_encode([collect($cursor),$cursor instanceof Traversable,[] instanceof Traversable,is_iterable([])]);
abstract class StreamBase implements Traversable {} class One extends StreamBase implements IteratorAggregate {public function getIterator(): Traversable {yield 8;}}
echo PHP_EOL,json_encode(collect(new One()));
[[2,4],true,false,true]
[8]

Examples

<?php
function collect(Traversable $items): array {return iterator_to_array($items,false);}
$cursor=new ArrayIterator([2,4]); echo json_encode([collect($cursor),$cursor instanceof Traversable,[] instanceof Traversable,is_iterable([])]);
abstract class StreamBase implements Traversable {} class One extends StreamBase implements IteratorAggregate {public function getIterator(): Traversable {yield 8;}}
echo PHP_EOL,json_encode(collect(new One()));

Result

[[2,4],true,false,true]
[8]

Sources