WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

IteratorAggregate

Gibt einer Sammlung mit getIterator(): Traversable einen externen Cursor.

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

Syntax

class Labels implements IteratorAggregate

Gibt einer Sammlung mit getIterator(): Traversable einen externen Cursor. Ein neuer Iterator je Aufruf erlaubt unabhängige verschachtelte und wiederholte Durchläufe. Liefert das Objekt immer denselben Generator, wirft ein zweites foreach über den bereits geschlossenen Generator Exception. Im Beispiel liefert IteratorAggregate::getIterator bei jedem Aufruf einen neuen Generator: Das Bewegen des linken Cursors bewegt den rechten nicht.

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

Beispiele

<?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);}

Ergebnis

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

Quellen