The MultipleIterator class

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

简介

An Iterator that sequentially iterates over all attached iterators

类摘要

class MultipleIterator implements Iterator {

/* 常量 */

const int MIT_NEED_ANY = 0;

const int MIT_NEED_ALL = 1;

const int MIT_KEYS_NUMERIC = 0;

const int MIT_KEYS_ASSOC = 2;

/* 方法 */

public __construct(int $flags = MultipleIterator::MIT_NEED_ALL | MultipleIterator::MIT_KEYS_NUMERIC)

public attachIterator(Iterator $iterator, string|int|null $info = null): void

public containsIterator(Iterator $iterator): bool

public countIterators(): int

public current(): array

public detachIterator(Iterator $iterator): void

public getFlags(): int

public key(): array

public next(): void

public rewind(): void

public setFlags(int $flags): void

public valid(): bool

}

预定义常量

MultipleIterator::MIT_NEED_ANY: Do not require all sub iterators to be valid in iteration.
MultipleIterator::MIT_NEED_ALL: Require all sub iterators to be valid in iteration.
MultipleIterator::MIT_KEYS_NUMERIC: Keys are created from the sub iterators position.
MultipleIterator::MIT_KEYS_ASSOC: Keys are created from sub iterators associated information.

MultipleIterator::attachIterator — Attaches iterator information
MultipleIterator::__construct — Constructs a new MultipleIterator
MultipleIterator::containsIterator — Checks if an iterator is attached
MultipleIterator::countIterators — Gets the number of attached iterator instances
MultipleIterator::current — Gets the registered iterator instances
MultipleIterator::detachIterator — Detaches an iterator
MultipleIterator::getFlags — Gets the flag information
MultipleIterator::key — Gets the registered iterator instances
MultipleIterator::next — Moves all attached iterator instances forward
MultipleIterator::rewind — Rewinds all attached iterator instances
MultipleIterator::setFlags — Sets flags
MultipleIterator::valid — Checks the validity of sub iterators

add a note

User Contributed Notes 1 note

down

sven at rtbg dot de ¶

7 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.

add a note

官方地址：https://www.php.net/manual/en/class.multipleiterator.php

有任何技术问题请点击这里网站运营推广招聘

IT PHP 编程语言 Linux 开发编程科技 Elasticsearch HTML/CSS/XML 网络 JAVA NoSQL 数据库面试 C/C++ Golang Git 算法操作系统正则表达式 Redis 互联网 MySql JavaScript 运维软件国际架构设计 Mac OS TCP/IP Excel Vim Windows Socket Oracle VR MongoDB Python 运营 MemCache 商业硬件电子娱乐设计 nginx 摄影游戏 WordPress HTTP 团建数码电器

php7 安装fileinfo扩展 preg_split — 通过一个正则表达式分隔字符串 php位值,解决 PHP 中 usort 在值相同时改变原始位置的问题 [PHP] inet_pton/inet_ntop IP地址转换函数 array_multisort() 多字段排序 PHPMailer设置utf8 PHPMailer字符集CharSet ADORecordSet对象 adodb手册 PHP 8.1 [鸟哥]PHP_INT_MIN 和 -9223372036854775808 opcache预加载 Composer的Packagist资源 mysql面试题 [鸟哥]PHP FFI详解 - 一种全新的PHP扩展方式 PHP7添加redis扩展 PHP mkdir()写出来的权限与mode值不符合 Packagist / Composer 中国全量镜像 PHP获取指定函数定义在哪个文件中及行号 PHPstorm 里面Terminal 不能使用 esc键吗退出编辑模式吗支持php7的性能采集扩展

略微加速

PHP官方手册 - 互联网笔记

The MultipleIterator class

简介

类摘要

预定义常量

目录

User Contributed Notes 1 note