CachingIterator::rewind()函数—用法及示例

函数名称：CachingIterator::rewind()

函数描述：CachingIterator::rewind() 方法用于将迭代器的内部指针重置到第一个元素。

适用版本：该函数在 PHP 5，PHP 7 及以上版本中可用。

语法：void CachingIterator::rewind ( void )

参数：该函数没有任何参数。

返回值：该函数没有返回值。

示例：

// 创建一个迭代器
$iterator = new ArrayIterator([1, 2, 3]);

// 创建一个缓存迭代器
$cachedIterator = new CachingIterator($iterator);

// 重置内部指针到第一个元素
$cachedIterator->rewind();

// 打印第一个元素
echo $cachedIterator->current(); // 输出：1

该示例中，我们首先创建了一个 ArrayIterator，它包含了一个简单的数组 [1, 2, 3]。然后，我们使用这个 ArrayIterator 创建了一个 CachingIterator，用于缓存迭代器的元素。接下来，使用 rewind() 方法重置了缓存迭代器的内部指针到第一个元素。最后，通过 current() 方法获取当前元素并打印出来。

需要注意的是，CachingIterator 是一个迭代器装饰器，它可以包装其他实现了 Iterator 接口的迭代器。使用 CachingIterator 可以在迭代过程中缓存迭代器的所有元素，方便我们随时访问元素。在本例中，我们将 ArrayIterator 包装在 CachingIterator 中，以便我们可以在重置内部指针后访问第一个元素。