array_replace

    (PHP 5 >= 5.3.0, PHP 7, PHP 8)

    array_replace — 渡された配列の要素を置き換える

    説明

    array_replace(array$array, array...$replacements): array

    array_replace() は、 array の値をそれ以降の配列の同じ要素の値で置き換えます。 最初の配列のキーと同じキーが 2 番目の配列にあれば、 2 番目の配列の値が最初の配列の値を上書きします。 2 番目の配列に存在するキーが最初の配列に存在しなければ、 そのキーが新たに最初の配列内に作られます。 最初の配列にしか存在しないキーについては何も変わりません。 置き換え用の配列が複数渡された場合は渡した順に処理を行い、 後から渡した配列の値のほうが優先されます。

    array_replace() は再起的な処理を行いません。 2 番目の配列の値がどんな型であっても、最初の配列の値を置き換えます。

    パラメータ

    array

    要素を置き換えたい配列。

    replacements

    置き換えたい要素を含む配列。 後から渡した配列の値のほうが優先されます。

    戻り値

    配列を返します。

    例

    例1 array_replace() の例

    <?php
    $base     = array("orange", "banana", "apple", "raspberry");
    $replacements = array(0 => "pineapple", 4 => "cherry");
    $replacements2 = array(0 => "grape");

    $basket = array_replace($base, $replacements, $replacements2);
    print_r($basket);
    ?>

    上の例の出力は以下となります。

    Array ( [0] => grape [1] => banana [2] => apple [3] => raspberry [4] => cherry )

    参考

    To Top