The IteratorAggregate interface

Увод

Interface to create an external Iterator.

Interface synopsis

IteratorAggregate

IteratorAggregate extends Traversable {

/* Methods */

abstract public Traversable getIterator ( void )

}

Example #1 Basic usage


<?php
class myData implements IteratorAggregate {
    public $property1 = "Public property one";
    public $property2 = "Public property two";
    public $property3 = "Public property three";

    public function __construct() {
        $this->property4 = "last property";
    }

    public function getIterator() {
        return new ArrayIterator($this);
    }
}

$obj = new myData;

foreach($obj as $key => $value) {
    var_dump($key, $value);
    echo "\n";
}
?>

Примерът по-горе ще изведе нещо подобно на:

string(9) "property1"
string(19) "Public property one"

string(9) "property2"
string(19) "Public property two"

string(9) "property3"
string(21) "Public property three"

string(9) "property4"
string(13) "last property"

Съдържание

IteratorAggregate::getIterator — Retrieve an external iterator

add a note User Contributed Notes IteratorAggregate

Tab Atkins 29-Apr-2012 04:11


Note that, at least as of 5.3, you still aren't allowed to return a normal Array from getIterator().



In some places, the docs wrap the array into an ArrayObject and return that.  DON'T DO IT.  ArrayObject drops any empty-string keys on the floor when you iterate over it (again, at least as of 5.3).



Use ArrayIterator instead.  I wouldn't be surprised if it didn't have its own set of wonderful bugs, but at the very least it works correctly when you use it with this method.

add a note