HOWTO · PHP

PHP スプレッド オペレーター

このチュートリアルでは、PHP のスプレッド オペレーターについて説明します。

このページの内容

このチュートリアルでは、PHP のスプレッド オペレーターについて説明します。

PHP スプレッド オペレーター

PHP 7.4 で導入されたスプレッド演算子は、配列式に使用されます。 拡散演算子は、3つのドット ... で表されます。

スプレッド演算子は、配列のメンバーを分散します。つまり、これら 3つのドットを配列のプレフィックスに入れると、値がその場所に分散されます。

例えば:

<?php
$names = ["Jack", "John"];

$all_names = ["Mike", "Logan", "Shawn", ...$names]; // Use of the spread operator

print_r($all_names);
?>

上記のコードは、スプレッド演算子を使用して、配列 $names の値を配列 $all_names に入れます。

出力を参照してください:

Array (
    [0] => Mike
	[1] => Logan
	[2] => Shawn
	[3] => Jack
	[4] => John )

array_merge() メソッドも同じ操作を実行しますが、拡散演算子は常にメソッドよりも優れた言語構造であるため優れています。PHP はコンパイル時に配列のパフォーマンスも最適化します。

スプレッド演算子は、配列のどこでも使用できます。たとえば、先頭、中間、末尾などです。

例を見てみましょう。

<?php
$names = ["Jack", "John"];

$all_names = ["Mike", ...$names, "Logan", "Shawn" ]; // Use of the spread operator in between

print_r($all_names);

echo "<br>";

$all_names1 = [...$names, "Mike", "Logan", "Shawn" ]; // Use of the spread operator at the begining

print_r($all_names1);
?>

このコードは、スプレッド演算子をさまざまな位置で使用して、$names 配列を $all_names 配列に挿入します。

出力を参照してください:

Array (
    [0] => Mike
    [1] => Jack
	[2] => John
	[3] => Logan
	[4] => Shawn )

Array (
    [0] => Jack
	[1] => John
	[2] => Mike
	[3] => Logan
	[4] => Shawn )

スプレッド演算子は、位置、時間、関数またはジェネレーターなどに応じて、さまざまな方法で使用できます。PHP のスプレッド演算子の使用方法ごとに例を試してみましょう。

PHP で Spread Operator を複数回使用する

スプレッド演算子は、配列内で複数回使用することもできます。 例を試してみましょう。

<?php
$names1 = ["Jack", "John"];

$names2 = ["Mike", ...$names1, "Logan", "Shawn" ]; // Use of the spread operator

$all_names = [...$names1, ...$names2 ]; // Use of the multiple spread operator

print_r($all_names);
?>

上記のコードは、拡散演算子の複数の使用法を示しています。 出力を参照してください:

Array (
    [0] => Jack
	[1] => John
	[2] => Mike
	[3] => Jack
	[4] => John
	[5] => Logan
	[6] => Shawn )

PHP の関数の戻り値でスプレッド演算子を使用する

たとえば、関数が配列を返す場合、その関数呼び出しでスプレッド演算子を使用して、それらの値を配列に入れることができます。 例を参照してください。

<?php

function get_names()
{
    $names = ["Jack", "John"];
    return $names;
}

$names1 = ["Mike", "Logan", "Shawn" ];

$all_names = [...$names1, ...get_names() ]; // Use of the multiple spread operator with function call

print_r($all_names);
?>

上記のコードは、関数の戻り値で PHP スプレッド演算子を使用する方法を示しています。

出力を参照してください:

Array (
    [0] => Mike
	[1] => Logan
	[2] => Shawn
	[3] => Jack
	[4] => John )

PHP で Traversable オブジェクトで Spread Operator を使用する

PHP スプレッド演算子は、配列だけでなくオブジェクトでも使用できます。 また、トラバース可能なオブジェクト、つまりトラバース可能なインターフェースを実装するオブジェクトでも使用できます。

例を試してみましょう。

<?php
class Names implements IteratorAggregate
{
    private $names = ["Mike", "Logan", "Shawn" ];

    public function getIterator()
    {
        return new ArrayIterator($this->names);
    }
}

$names = new Names();
$all_names = [...$names];

print_r($all_names);
?>

上記のコードは、トラバース可能なオブジェクトでスプレッド演算子を使用する方法を示しています。

出力を参照してください:

Array (
    [0] => Mike
	[1] => Logan
	[2] => Shawn )

PHP のジェネレーターで Spread Operator を使用する

スプレッド演算子は、ジェネレータ関数でも使用できます。

例えば:

<?php
function odd_numbers()
{
    for($x =1; $x < 20; $x+=2){
        yield $x;
    }
}

$odd = [...odd_numbers()];

print_r($odd);
?>

上記のコードは、1 から 20 までの奇数を生成し、スプレッド演算子を使用するジェネレータ関数を作成します。

出力を参照してください:

Array (
    [0] => 1
	[1] => 3
	[2] => 5
	[3] => 7
	[4] => 9
	[5] => 11
	[6] => 13
	[7] => 15
	[8] => 17
	[9] => 19 )