CachingIterator::setFlags
(PHP 5 >= 5.2.0, PHP 7, PHP 8)
CachingIterator::setFlags — Set the flags for the CachingIterator object
说明
Replaces the flags of the CachingIterator with
flags.
Turning CachingIterator::FULL_CACHE on empties the
cache; elements are added to it from the next move of the iterator onwards.
参数
flags
A bitmask of the
CachingIterator constants.
At most one of CachingIterator::CALL_TOSTRING,
CachingIterator::TOSTRING_USE_KEY,
CachingIterator::TOSTRING_USE_CURRENT and
CachingIterator::TOSTRING_USE_INNER may be given.
返回值
没有返回值。
错误/异常
Throws a ValueError if
flags contains more than one of
CachingIterator::CALL_TOSTRING,
CachingIterator::TOSTRING_USE_KEY,
CachingIterator::TOSTRING_USE_CURRENT and
CachingIterator::TOSTRING_USE_INNER.
Throws an InvalidArgumentException if
CachingIterator::CALL_TOSTRING or
CachingIterator::TOSTRING_USE_INNER is currently set
and flags does not contain it, as these flags
cannot be unset.
更新日志
| 版本 | 说明 |
|---|---|
| 8.0.0 |
Now throws a ValueError if
flags contains more than one of the string
conversion flags; previously, an
InvalidArgumentException was thrown.
|
示例
示例 #1 Turning on the full cache
<?php
$iterator = new CachingIterator(new ArrayIterator(['a', 'b', 'c']), 0);
$iterator->setFlags(CachingIterator::FULL_CACHE);
foreach ($iterator as $value) {
// ...
}
var_dump($iterator->getCache());
?>以上示例会输出:
array(3) {
[0]=>
string(1) "a"
[1]=>
string(1) "b"
[2]=>
string(1) "c"
}
参见
- CachingIterator::getFlags() - Get flags used
- CachingIterator::__construct() - Construct a new CachingIterator object for the iterator
来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。
