【PHP8.x】validメソッドの使い方

validメソッドは、イテレータの現在の位置が有効かどうかをチェックする処理を実行するメソッドです。AppendIteratorクラスは、複数のイテレータを一つに連結し、連続した一つのイテレータとして扱う機能を提供します。このクラスにおいてvalidメソッドが呼び出されると、現在アクティブになっている内部イテレータの有効性が確認されます。具体的には、AppendIteratorが内部で保持しているイテレータのvalidメソッドを呼び出し、その結果をそのまま返します。もし現在の位置に有効な要素が存在する場合はtrueを、これ以上たどる要素がない場合やイテレータの終端に達した場合はfalseを返します。foreach文などの反復処理でAppendIteratorを使用する際、ループの各ステップでこのメソッドが内部的に評価され、ループを継続するか終了するかを決定するために利用されます。すべての内部イテレータの走査が完了した時点で、このメソッドがfalseを返すことによって、反復処理は正常に終了します。

Copy
1<?php
2
3// 2つの異なるイテレータを準備します
4$arrayIterator1 = new ArrayIterator(['a', 'b']);
5$arrayIterator2 = new ArrayIterator(['c', 'd']);
6
7// AppendIterator を作成し、2つのイテレータを連結します
8$appendIterator = new AppendIterator();
9$appendIterator->append($arrayIterator1);
10$appendIterator->append($arrayIterator2);
11
12// イテレータを先頭に巻き戻します
13$appendIterator->rewind();
14
15// valid()メソッドが true を返す間、ループを続けます
16// これは、イテレータが有効な要素を指しているかどうかをチェックします
17while ($appendIterator->valid()) {
18    echo $appendIterator->current() . PHP_EOL;
19    $appendIterator->next();
20}
21
22// ループ終了後、イテレータは終端を超えているため、valid()は false を返します
23// var_dump($appendIterator->valid()); // 出力: bool(false)
24
25?>

引数なし

引数はありません

bool

AppendIterator::validメソッドは、現在のイテレータが有効な要素を持っている場合に true を、そうでない場合に false を返します。