MultipleIterator クラス
(PHP 5 >= 5.3.0, PHP 7, PHP 8)
はじめに
アタッチしたすべてのイテレータを順に処理するイテレータです。
クラス概要
/* 定数 */
/* メソッド */
public __construct(int
}$flags
= MultipleIterator::MIT_NEED_ALL | MultipleIterator::MIT_KEYS_NUMERIC)定義済み定数
MultipleIterator::MIT_NEED_ANY
-
すべてのサブイテレータが処理可能である必要はありません。
MultipleIterator::MIT_NEED_ALL
-
すべてのサブイテレータが正しく反復処理できることを要求します。
MultipleIterator::MIT_KEYS_NUMERIC
-
キーは、サブイテレータの位置から作成されます。
MultipleIterator::MIT_KEYS_ASSOC
-
キーは、サブイテレータに関連付けられた情報から作成されます。
目次
- MultipleIterator::attachIterator — イテレータの情報をアタッチする
- MultipleIterator::__construct — 新しい MultipleIterator を作成する
- MultipleIterator::containsIterator — イテレータがアタッチされているかどうかを調べる
- MultipleIterator::countIterators — アタッチされているイテレータインスタンスの数を取得する
- MultipleIterator::current — 登録されているイテレータインスタンスを取得する
- MultipleIterator::detachIterator — イテレータをデタッチする
- MultipleIterator::getFlags — フラグの情報を取得する
- MultipleIterator::key — 登録されているイテレータインスタンスを取得する
- MultipleIterator::next — アタッチしているすべてのイテレータインスタンスを次に移動させる
- MultipleIterator::rewind — アタッチしているすべてのイテレータインスタンスを巻き戻す
- MultipleIterator::setFlags — フラグを設定する
- MultipleIterator::valid — サブイテレータの有効性を調べる
+add a note
User Contributed Notes 1 note
sven at rtbg dot de ¶
9 years ago
This iterator has a misleading name and description - it actually acts as a parallel iterator: You attach one or more iterators with a key, integer or NULL, and when you iterate over the MultipleIterator, as the result for current() you get ALL results from all attached iterators as an array (under the key or integer you attached it with), and the same is true for the key() call.
valid() will be valid if any or all iterators are valid, depending on the setting of the $flags - with ANY, you can iterate over a set of iterators with some of them ending before others, and get NULL results from these iterators until the last iterator is at it's end. With ALL, iteration stops when the first iterator stops delivering results.
next() and rewind() will be called on all attached iterators in every case.
<?php
$it1 = new ArrayIterator(array(1,2,3));
$it2 = new ArrayIterator(array(4,5,6));
$multipleIterator = new MultipleIterator(MultipleIterator::MIT_NEED_ALL|MultipleIterator::MIT_KEYS_ASSOC);
$multipleIterator->attachIterator($it1, 1);
$multipleIterator->attachIterator($it2, 'second');
foreach ($multipleIterator as $key => $value) {
echo "Key\n"; var_dump($key);
echo "Value\n"; var_dump($value);
echo "---next---\n";
}
?>
Result with PHP 5.5.0 and up:
Key
array(2) {
[1]=>
int(0)
["second"]=>
int(0)
}
Value
array(2) {
[1]=>
int(1)
["second"]=>
int(4)
}
---next---
Key
array(2) {
[1]=>
int(1)
["second"]=>
int(1)
}
Value
array(2) {
[1]=>
int(2)
["second"]=>
int(5)
}
---next---
Key
array(2) {
[1]=>
int(2)
["second"]=>
int(2)
}
Value
array(2) {
[1]=>
int(3)
["second"]=>
int(6)
}
---next---
Note that PHP 5.4 and 5.3 do not support accessing the key() values in foreach loops because they expect them to not be an array - doing so will cause "Warning: Illegal type returned from MultipleIterator::key()" and the result of (int)0 as the key for all iterations.
Without the MultipleIterator::MIT_KEYS_ASSOC flag, the MultipleIterator will create numeric indices based on the order of attachment.
↑ and ↓ to navigate •
Enter to select •
Esc to close
Press Enter without
selection to search using Google