php如何实现迭代器？PHP迭代器(Iterator)接口实现

Iterator

rewind()

current()

key()

next()

valid()

foreach

foreach

Iterator

MyCollection

foreach

<?php

class MyCollection implements Iterator
{
    private array $items = [];
    private int $position = 0; // 内部指针，记录当前遍历到的位置

    public function __construct(array $data = [])
    {
        $this->items = $data;
        $this->position = 0; // 初始位置设为0
    }

    // 实现 Iterator 接口的方法

    /**
     * 重置迭代器到第一个元素。
     * 这是 foreach 循环开始时或手动调用 reset() 时会调用的方法。
     */
    public function rewind(): void
    {
        // 坦白说，每次开始遍历时，我们都需要确保指针指向集合的开头。
        // 这就好像你翻开一本书，总是从第一页开始读。
        $this->position = 0;
        echo "rewind: 指针已重置到开始。\n";
    }

    /**
     * 返回当前位置的元素。
     * foreach 循环的每次迭代都会调用此方法来获取值。
     */
    public function current(): mixed
    {
        // 拿到当前指针指向的“东西”。如果指针越界了，就返回null或者抛异常，
        // 但通常情况下，valid() 方法会先帮我们处理掉越界的情况。
        echo "current: 获取当前元素 {$this->items[$this->position]}\n";
        return $this->items[$this->position];
    }

    /**
     * 返回当前位置的键。
     * foreach 循环的每次迭代都会调用此方法来获取键。
     */
    public function key(): mixed
    {
        // 返回当前元素的键。对于数组，通常就是索引。
        echo "key: 获取当前键 {$this->position}\n";
        return $this->position;
    }

    /**
     * 移动到下一个元素。
     * foreach 循环的每次迭代（获取完当前值后）都会调用此方法。
     */
    public function next(): void
    {
        // 简单粗暴地把指针往后挪一位。
        // 这就是迭代的本质，一步一步往前走。
        $this->position++;
        echo "next: 指针已移动到下一位 {$this->position}\n";
    }

    /**
     * 检查当前位置是否有效。
     * foreach 循环在每次迭代前都会调用此方法来判断是否还有更多元素可遍历。
     */
    public function valid(): bool
    {
        // 判断当前指针是否还在集合的有效范围内。
        // 如果越界了，说明遍历结束了。
        $isValid = isset($this->items[$this->position]);
        echo "valid: 检查位置 {$this->position} 是否有效？" . ($isValid ? "是" : "否") . "\n";
        return $isValid;
    }
}

// 使用我们的自定义集合
$myCollection = new MyCollection(['Apple', 'Banana', 'Cherry', 'Date']);

echo "开始遍历 MyCollection：\n";
foreach ($myCollection as $key => $value) {
    echo "遍历中：键 = {$key}, 值 = {$value}\n";
}
echo "遍历结束。\n";

echo "\n再次遍历 MyCollection，看rewind是否生效：\n";
foreach ($myCollection as $key => $value) {
    echo "再次遍历中：键 = {$key}, 值 = {$value}\n";
}
echo "再次遍历结束。\n";

?>

rewind

valid

current

key

next

foreach

rewind()

valid()

current()

key()

next()

LogFileIterator

next()

MyCollection

Iterator

IteratorAggregate

<?php

// 实现了 IteratorAggregate 的类
class DataContainer implements IteratorAggregate
{
    private array $data;

    public function __construct(array $data)
    {
        $this->data = $data;
    }

    /**
     * 返回一个 Iterator 实例。
     */
    public function getIterator(): Traversable
    {
        // 这里我们可以返回一个内置的 ArrayIterator，
        // 或者我们自定义的 MyCollectionIterator (如果它实现了Iterator)
        // 甚至可以根据某些条件返回不同的迭代器
        return new ArrayIterator($this->data);
    }
}

$container = new DataContainer(['Alpha', 'Beta', 'Gamma']);

echo "\n遍历 DataContainer (通过 IteratorAggregate):\n";
foreach ($container as $item) {
    echo "元素: {$item}\n";
}
echo "遍历结束。\n";

?>

IteratorAggregate

IteratorAggregate

Iterator