PHP迭代器与关联数组：实现灵活的自定义遍历

<?php
class MyIterator implements Iterator {
  private $items = [];
  private $pointer = 0;

  public function __construct($items) {
    // array_values() 会将所有键转换为数字索引
    $this->items = array_values($items);
  }

  public function current() {
    return $this->items[$this->pointer];
  }

  public function key() {
    return $this->pointer;
  }

  public function next() {
    $this->pointer++;
  }

  public function rewind() {
    $this->pointer = 0;
  }

  public function valid() {
    return $this->pointer < count($this->items);
  }
}

// 遍历可迭代对象的函数
function printIterable(iterable $myIterable) {
  foreach($myIterable as $itemKey => $itemValue) {
    echo "$itemKey - $itemValue\n";
  }
}

// 使用数字索引数组
echo "--- 数字索引数组示例 ---\n";
$numericIterator = new MyIterator(["a", "b", "c"]);
printIterable($numericIterator);
// 输出:
// 0 - a
// 1 - b
// 2 - c

// 尝试使用关联数组
echo "\n--- 关联数组示例 ---\n";
$associativeIterator = new MyIterator(["a"=>1, "b"=>2, "c"=>3]);
printIterable($associativeIterator);
// 预期输出:
// a - 1
// b - 2
// c - 3
// 实际输出:
// 0 - 1
// 1 - 2
// 2 - 3
?>

<?php
class MyIteratorDelegated implements Iterator {
  private $items = [];

  public function __construct($items) {
    // 不再使用 array_values()，保留原始键
    $this->items = $items;
  }

  public function current() {
    // 返回内部数组当前指针的值
    return current($this->items);
  }

  public function key() {
    // 返回内部数组当前指针的键
    return key($this->items);
  }

  public function next() {
    // 移动内部数组指针到下一个元素
    next($this->items);
  }

  public function rewind() {
    // 重置内部数组指针到第一个元素
    reset($this->items);
  }

  public function valid() {
    // 检查内部数组当前指针是否有效
    // 当 key() 返回 null 时，表示已到达数组末尾
    return key($this->items) !== null;
  }
}

// 遍历可迭代对象的函数
function printIterable(iterable $myIterable) {
  foreach($myIterable as $itemKey => $itemValue) {
    echo "$itemKey - $itemValue\n";
  }
}

// 使用关联数组进行测试
echo "--- 委托式迭代器 (关联数组) ---\n";
$associativeIteratorDelegated = new MyIteratorDelegated(["a"=>1, "b"=>2, "c"=>3]);
printIterable($associativeIteratorDelegated);
// 预期输出:
// a - 1
// b - 2
// c - 3

// 使用数字索引数组进行测试
echo "\n--- 委托式迭代器 (数字索引数组) ---\n";
$numericIteratorDelegated = new MyIteratorDelegated(["apple", "banana", "cherry"]);
printIterable($numericIteratorDelegated);
// 预期输出:
// 0 - apple
// 1 - banana
// 2 - cherry
?>

<?php
class MyIteratorExplicitKeys implements Iterator {
  private $items = []; // 存储原始数据，保留关联键
  private $keys = [];  // 存储原始数据的键列表
  private $pointer = 0; // 内部数字指针，用于索引 $keys 数组

  public function __construct($items) {
    $this->items = $items; // 保留原始键值对
    $this->keys = array_keys($items); // 提取所有键
  }

  public function current() {
    // 使用 $pointer 从 $keys 中获取当前键，再用此键从 $items 中获取值
    return $this->items[$this->key()];
  }

  public function key() {
    // 返回 $keys 数组中当前指针对应的键
    return $this->keys[$this->pointer];
  }

  public function next() {
    $this->pointer++;
  }

  public function rewind() {
    $this->pointer = 0;
  }

  public function valid() {
    // 检查内部指针是否在 $keys 数组的有效范围内
    return $this->pointer < count($this->keys);
  }
}

// 遍历可迭代对象的函数
function printIterable(iterable $myIterable) {
  foreach($myIterable as $itemKey => $itemValue) {
    echo "$itemKey - $itemValue\n";
  }
}

// 使用关联数组进行测试
echo "--- 显式键列表迭代器 (关联数组) ---\n";
$associativeIteratorExplicit = new MyIteratorExplicitKeys(["a"=>1, "b"=>2, "c"=>3]);
printIterable($associativeIteratorExplicit);
// 预期输出:
// a - 1
// b - 2
// c - 3

// 使用数字索引数组进行测试
echo "\n--- 显式键列表迭代器 (数字索引数组) ---\n";
$numericIteratorExplicit = new MyIteratorExplicitKeys(["apple", "banana", "cherry"]);
printIterable($numericIteratorExplicit);
// 预期输出:
// 0 - apple
// 1 - banana
// 2 - cherry
?>