(PHP 5 >= 5.3.0, PHP 7)
array_replace — Ersetzt Elemente von übergebenen Arrays im ersten Array
$array1
, array $array2
[, array $...
] )
array_replace() ersetzt die Werte von
array1 mit Werten, die die selben Schlüssel in den folgenden
Arrays haben. Wenn ein Schlüssel des ersten Arrays im zweiten Array existiert, wird der Wert
durch den Wert im zweiten Array ersetzt. Wenn der Schlüssel im zweiten, jedoch nicht im
ersten Array existiert, wird dieser im ersten angelegt.
Wenn ein Schlüssel nur im ersten Array existiert, bleibt dieser erhalten.
Wenn mehrere Arrays zur Ersetzung übergeben werden, läuft die Abarbeitung der Reihe nach und spätere
Arrays überschreiben vorherige Werte.
array_replace() ist nicht rekursiv: Werte im ersten Array werden, egal mit welchem Datentyp aus dem Zweiten Array ersetzt.
array1Das Array in welchem die Elemente ersetzt werden.
array2Das Array aus dem Elemente extrahiert werden.
...Weitere Arrays, aus denen Elemente extrahiert werden. Werte späterer Arrays überschreiben die vorherigen Werte.
Gibt ein array zurück, oder NULL falls ein Fehler auftritt.
Beispiel #1 array_replace() Beispiel
<?php
$base = array("Orange", "Banane", "Apfel", "Himbeere");
$replacements = array(0 => "Ananas", 4 => "Kirsche");
$replacements2 = array(0 => "Traube");
$basket = array_replace($base, $replacements, $replacements2);
print_r($basket);
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Array
(
[0] => Traube
[1] => Banane
[2] => Apfel
[3] => Himbeere
[4] => Kirsche
)