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

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

作成日: 2025年09月11日更新日: 2026年01月08日

基本的な使い方

addメソッドは、SplQueueクラスのインスタンスに対して、キューの最後に新しい要素を追加するメソッドです。

SplQueueは、PHPの標準ライブラリ（SPL）が提供するデータ構造の一つで、データが「先入れ先出し」（FIFO: First-In, First-Out）の原則に基づいて管理されるキュー（待ち行列）を実装しています。このデータ構造は、タスクの実行順序を保証したり、イベント処理の順番を制御したりする場合などに非常に便利です。

addメソッドを利用すると、キューの現在の末尾に指定した値を加えることができます。引数 $value には、数値、文字列、オブジェクトなど、任意の型のデータを渡すことが可能です。このメソッドは、値をキューに追加するだけで、特別な戻り値はありません。

また、addメソッドは SplQueue::push メソッドのエイリアス（別名）として動作します。そのため、どちらのメソッドを使用しても同じ結果が得られますが、慣例として要素の追加には push が用いられることもあります。このメソッドを使うことで、キューにデータを効率的かつ安全に追加し、プログラム内でデータの処理順序を適切に制御することができます。

構文(syntax)


1<?php
2
3$queue = new SplQueue();
4$queue->add("追加する値");

引数(parameters)

int $index, mixed $value

int $index: 追加する要素のインデックス（位置）を指定する整数
mixed $value: キューに追加する値

戻り値(return)

戻り値なし

戻り値はありません