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

addAllメソッドは、SplObjectStorageインスタンスに、別のSplObjectStorageインスタンスや、オブジェクトを格納する反復可能な（Traversable）データソースから、全てのオブジェクトをまとめて追加するメソッドです。

SplObjectStorageは、PHPの標準拡張（SPL）が提供する特殊なコレクションで、オブジェクトそのものをキーとして管理し、関連するデータを保持する機能を持っています。このaddAllメソッドは、特に複数のオブジェクトグループを一つのSplObjectStorageに統合したい場合に非常に有用です。

引数には、追加したいオブジェクトが含まれるSplObjectStorageオブジェクト、または、foreachループで反復可能なオブジェクト（例えば、オブジェクトを含む配列など）を指定します。メソッドが実行されると、指定されたデータソースに含まれる全てのオブジェクトが、呼び出し元のSplObjectStorageに追加されます。

ここで重要なのは、SplObjectStorageはオブジェクトの重複を自動的に排除する特性を持っている点です。そのため、既に追加されているオブジェクトが引数として指定されたデータソースに含まれていても、二重に登録されることはなく、元のSplObjectStorageの状態が維持されます。このメソッドは追加操作のみを行い、値を返しません（void）。複数のオブジェクト集合を効率的に管理し、重複を気にせずに統合する際に活用いただけます。

Copy
1<?php
2$storageA = new SplObjectStorage();
3$object1 = new stdClass();
4$storageA->attach($object1);
5
6$storageB = new SplObjectStorage();
7$object2 = new stdClass();
8$storageB->attach($object2);
9
10$storageA->addAll($storageB);

SplObjectStorage $storage

• SplObjectStorage $storage: 追加したいオブジェクトと関連付けられたデータが含まれる SplObjectStorage オブジェクト

戻り値なし

戻り値はありません