array_replace
(PHP 5 >= 5.3.0, PHP 7, PHP 8)
array_replace — Ersetzt Elemente von übergebenen Arrays im ersten Array
Beschreibung
$array
, array ...$replacements
): array
array_replace() ersetzt die Werte von
array
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.
Parameter-Liste
-
array
-
Das Array in welchem die Elemente ersetzt werden.
-
replacements
-
Arrays, aus denen Elemente extrahiert werden. Werte späterer Arrays überschreiben die vorherigen Werte.
Rückgabewerte
Gibt ein array zurück.
Beispiele
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 )
Siehe auch
- array_replace_recursive() - Replaces elements from passed arrays into the first array recursively
- array_merge() - Führt zwei oder mehr Arrays zusammen