База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / PHP

IteratorAggregate

Предоставя външен курсор на колекцията чрез getIterator(): Traversable.

Версия: PHP 8.4; repository runtime, production runtime not attested

Синтаксис

class Labels implements IteratorAggregate

Предоставя външен курсор на колекцията чрез getIterator(): Traversable. Нов итератор при всяко извикване позволява независими вложени и повторни обхождания. Ако обектът връща все същия генератор, втори foreach над затворения генератор хвърля Exception. В примера IteratorAggregate::getIterator връща нов генератор при всяко извикване, затова преместването на левия курсор не мести десния.

class Labels implements IteratorAggregate { public function getIterator(): Traversable { yield "a"=>1; yield "b"=>2; } }
$labels=new Labels(); $left=$labels->getIterator(); $right=$labels->getIterator(); $left->next();
echo json_encode([$left->current(),$right->current(),iterator_to_array($labels)]);
class Once implements IteratorAggregate { public function __construct(private Generator $g){} public function getIterator(): Traversable {return $this->g;} }
$once=new Once($labels->getIterator()); foreach($once as $v){} try{foreach($once as $v){}}catch(Exception $e){echo PHP_EOL,get_class($e);}
[2,1,{"a":1,"b":2}]
Exception

Примери

<?php
class Labels implements IteratorAggregate { public function getIterator(): Traversable { yield "a"=>1; yield "b"=>2; } }
$labels=new Labels(); $left=$labels->getIterator(); $right=$labels->getIterator(); $left->next();
echo json_encode([$left->current(),$right->current(),iterator_to_array($labels)]);
class Once implements IteratorAggregate { public function __construct(private Generator $g){} public function getIterator(): Traversable {return $this->g;} }
$once=new Once($labels->getIterator()); foreach($once as $v){} try{foreach($once as $v){}}catch(Exception $e){echo PHP_EOL,get_class($e);}

Резултат

[2,1,{"a":1,"b":2}]
Exception

Източници