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): arrayAccept 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]