(PHP 5, PHP 7, PHP 8)
此物件支援對另一個迭代器進行快取迭代。
CachingIterator::CALL_TOSTRING將每個元素轉換為字串。
CachingIterator::CATCH_GET_CHILD在訪問子項時不拋出例外。
CachingIterator::TOSTRING_USE_KEY使用 鍵 進行字串轉換。
CachingIterator::TOSTRING_USE_CURRENT使用 目前 值進行字串轉換。
CachingIterator::TOSTRING_USE_INNER使用 內部 迭代器進行字串轉換。
CachingIterator::FULL_CACHE快取所有讀取的資料。
| 版本 | 說明 |
|---|---|
| 8.0.0 | CachingIterator 現在實作了 Stringable 介面。 |
CachingIterator 與其他迭代器（例如 ArrayIterator）之間的唯一區別是 hasNext() 方法。
由於數據將被載入到記憶體中，CachingIterator 可以檢查給定的迭代器是否具有下一個元素。
讓我們用一個例子來演示
<?php
$iterator = new CachingIterator(new ArrayIterator(['C', 'C++', 'C#', 'PHP', 'Python', 'Go', 'Ruby']));
foreach ($iterator as $item) {
if ($iterator->hasNext()) {
echo $item.', ';
} else {
echo '和 '.$item;
}
}
// C, C++, C#, PHP, Python, Go, 和 Ruby
?>
在此範例中，我檢查迭代器是否具有下一個值，如果有的話，我會附加一個逗號，否則將「和」附加到最後一個元素。<?php
//此程式碼片段將印出所有已快取的元素 (foreach) 。
$cache = new CachingIterator(new ArrayIterator(range(1,100)), CachingIterator::FULL_CACHE);
foreach ($cache as $c) {
}
print_r($cache->getCache());
?>「在另一個迭代器上進行快取迭代」意味著此迭代器始終落後於內部迭代器一步。換句話說，第一次迭代將產生 null 值
<?php
$cit = new CachingIterator( new ArrayIterator( [ 'a', 'b', 'c'] ) );
echo $cit->current() ); // null
echo $cit->getInnerIterator()->current() ); // "a"
while($cit->hasNext()){
// 我們從 "next" 開始，因為第一個項目是 null
$cit->next();
echo $cit->current(), '<br>';
}
?>
以這種方式迭代，可以讓我們預先存取未來的項目（也就是內部迭代器的當前項目）。顯然，`FULL_CACHE` 旗標會自動取消預設的 `CALL_TOSTRING` 旗標。當其中一個值無法轉換為字串時，這一點很明顯：使用預設的 `CALL_TOSTRING` 旗標會拋出錯誤；如果沒有該旗標，或者使用 `FULL_CACHE` 旗標，則不會拋出錯誤。