MultipleIterator::current

アタッチされているイテレータの現在の要素を取得する

説明

public array MultipleIterator::current()

有効なイテレータそれぞれの Iterator::current をコールし、アタッチされているすべてのイテレータの現在の要素を取得します。

MultipleIterator::MIT_KEYS_NUMERIC の場合、 要素はイテレータをアタッチした順に並びます。 MultipleIterator::MIT_KEYS_ASSOC の場合、 MultipleIterator::attachIterator で各イテレータに関連づけた情報が、返される配列のキーになります。

パラメータ

この関数にはパラメータはありません。

戻り値

アタッチされている各イテレータの現在の要素を含む配列を返します。 MultipleIterator::MIT_NEED_ANY の場合、 無効なイテレータの要素は null になります。

エラー / 例外

アタッチされているイテレータがない場合、または MultipleIterator::MIT_NEED_ALL が設定されていて、 無効なイテレータがひとつでもある場合、 RuntimeException をスローします。

MultipleIterator::MIT_KEYS_ASSOC が設定されていて、 情報を関連づけずアタッチされたイテレータがある場合、 InvalidArgumentException をスローします。

変更履歴

バージョン 説明
8.1.0 アタッチされているイテレータがないときに MultipleIterator::current をコールすると、 RuntimeException をスローするようになりました。 これより前のバージョンでは、false を返していました。

例

例1 MultipleIterator::current の例

<?php
$iterator = new MultipleIterator(MultipleIterator::MIT_NEED_ANY | MultipleIterator::MIT_KEYS_ASSOC);
$iterator->attachIterator(new ArrayIterator(['a' => 'apple', 'b' => 'banana']), 'fruit');
$iterator->attachIterator(new ArrayIterator(['x' => 'red']), 'color');

$iterator->rewind();
while ($iterator->valid()) {
    var_dump($iterator->current());
    $iterator->next();
}
?>

上の例の出力は以下となります。

array(2) {
  ["fruit"]=>
  string(5) "apple"
  ["color"]=>
  string(3) "red"
}
array(2) {
  ["fruit"]=>
  string(6) "banana"
  ["color"]=>
  NULL
}

参考

  • MultipleIterator::key
  • MultipleIterator::valid