【PHP8.x】MultipleIterator::current()メソッドの使い方

currentメソッドは、MultipleIteratorが管理する複数のイテレータの現在の要素をまとめて取得するメソッドです。MultipleIteratorクラスは、複数の異なるデータセットやオブジェクトを同時に反復処理する際に利用され、それぞれのデータソースから同時に値を取得したい場合に非常に役立ちます。

このcurrentメソッドを呼び出すと、MultipleIteratorに追加されたすべてのイテレータが現在指し示している要素の値を、一つの配列としてまとめて取得することができます。返される配列の各要素は、追加されたイテレータが管理するデータの現在の値に対応します。例えば、二つの配列を同時にイテレートしている場合、currentメソッドは最初の配列の現在の要素と二番目の配列の現在の要素を格納した配列を返します。

これにより、複数のコレクションを並行して処理する際に、それぞれのイテレータの現在の状態を個別に取得する手間を省き、コードの記述を簡潔に保つことができます。特に、異なる種類のデータを同期させながら処理する場合や、複数の関連するリストを同時に走査してデータを結合するようなシナリオで、効率的なデータアクセスを実現します。

あくまで「現在の」要素を取得する機能であり、イテレータの内部ポインタを次の位置へ進める機能は持ちませんので、次の要素へ進むには別途MultipleIterator::next()メソッドを使用する必要があります。

Copy
1<?php
2$mit = new MultipleIterator(MultipleIterator::MIT_KEYS_ASSOC);
3$mit->attachIterator(new ArrayIterator(['apple', 'banana']), 'fruits');
4$mit->attachIterator(new ArrayIterator([1, 2]), 'numbers');
5
6$mit->rewind();
7$currentElement = $mit->current();
8?>

引数なし

引数はありません

mixed

MultipleIterator::current() は、現在ポインタが指しているイテレータの要素を返します。返される値は、各イテレータが保持する要素の型によって異なります。