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

appendメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

『appendメソッドは、既存のAppendIteratorオブジェクトに、新たなイテレータを追加で連結するために使用するメソッドです。AppendIteratorクラスは、複数のイテレータをあたかも一つの連続したイテレータであるかのように扱うことを可能にします。例えば、2つの配列を順番にループ処理したい場合、それぞれをArrayIteratorにしてからAppendIteratorでまとめることができます。appendメソッドは、AppendIteratorのインスタンスが作成された後に、動的にイテレータを追加したい場合に役立ちます。このメソッドを呼び出すと、引数で指定されたイテレータが、現在AppendIteratorが保持しているイテレータのリストの末尾に追加されます。これにより、foreach文などでAppendIteratorを反復処理する際に、元からあったイテレータの要素をすべて処理し終えた後、追加されたイテレータの要素が続けて処理されるようになります。引数にはIteratorインターフェースを実装したオブジェクトを渡す必要があり、メソッド自体は値を返しません。

構文(syntax)

1<?php
2
3// 複数のイテレータを連結するための AppendIterator オブジェクトを作成します。
4$appendIterator = new AppendIterator();
5
6// 1つ目のイテレータを作成します。
7$iterator1 = new ArrayIterator(['a', 'b', 'c']);
8
9// 2つ目のイテレータを作成します。
10$iterator2 = new ArrayIterator(['d', 'e', 'f']);
11
12// append() メソッドを使い、イテレータを AppendIterator に追加します。
13$appendIterator->append($iterator1);
14$appendIterator->append($iterator2);
15
16// 連結されたイテレータの全要素を順番に出力します。
17foreach ($appendIterator as $value) {
18    echo $value . PHP_EOL;
19}
20
21?>

引数(parameters)

Iterator $iterator

  • Iterator $iterator: 追加するイテレータを指定します

戻り値(return)

戻り値なし

戻り値はありません