PHP array_replace()-Funktion

Beispiel

Ersetzen Sie die Werte des ersten Arrays ($a1) durch die Werte des zweiten Arrays ($a2):

<?php$a1=array("rot","grün");$a2=array("blau","gelb");print_r(array_replace($a1,$a2));?>

Definition und Verwendung

Die Funktion array_replace() ersetzt die Werte des ersten Arrays durch die Werte des folgenden Arrays.

Tipp: Sie können der Funktion ein Array oder mehrere Arrays übergeben.

Wenn ein Schlüssel im ersten Array array1 und auch im zweiten Array array2 vorhanden ist, wird der Wert im ersten Array array1 durch den Wert im zweiten Array array2 ersetzt. Existiert ein Schlüssel nur im ersten Array array1, bleibt er unverändert. (Einzelheiten siehe Beispiel 1 unten)

Wenn im zweiten Array, Array2, ein Schlüssel vorhanden ist, aber nicht im ersten Array, Array1, wird das Element im ersten Array, Array1, erstellt. (Einzelheiten siehe Beispiel 2 unten)

Wenn mehrere Ersatzarrays übergeben werden, werden diese der Reihe nach verarbeitet und die Werte nachfolgender Arrays überschreiben die Werte vorheriger Arrays. (Einzelheiten siehe Beispiel 3 unten)

Tipp: Verwenden Sie array_replace_recursive(), um die Werte des ersten Arrays rekursiv durch die Werte nachfolgender Arrays zu ersetzen.

Grammatik

 array_replace( array1, array2, array3... )

Parameter	beschreiben
array1	Erforderlich. Geben Sie ein Array an.
array2	Optional. Gibt ein Array an, das den Wert von array1 ersetzen soll.
array3,...	Optional. Geben Sie mehrere Arrays an, um die Werte von Array1 und Array2 zu ersetzen, .... Die Werte im folgenden Array überschreiben die Werte im vorherigen Array.

technische Details

Rückgabewert:	Gibt das ersetzte Array oder NULL zurück, wenn ein Fehler auftritt.
PHP-Version:	5.3.0+

Weitere Beispiele

Beispiel 1

Wenn ein Schlüssel im ersten Array array1 und auch im zweiten Array array2 vorhanden ist, wird der Wert im ersten Array array1 durch den Wert im zweiten Array array2 ersetzt. Existiert ein Schlüssel nur im ersten Array array1, bleibt er unverändert.

<?php$a1=array("a"=>"rot",b"=>"grün");$a2=array("a"=>"orange","burgundy");print_r(array_replace( $a1,$a2));?>

Beispiel 2

Wenn im zweiten Array, Array2, ein Schlüssel vorhanden ist, aber nicht im ersten Array, Array1, wird das Element im ersten Array, Array1, erstellt.

<?php$a1=array("a"=>"red","green");$a2=array("a"=>"orange","b"=>"burgundy");print_r(array_replace( $a1,$a2));?>

Beispiel 3

Verwendung von drei Arrays – das letzte Array ($a3) überschreibt die vorherigen Arrays ($a1 und $a2):

<?php$a1=array("rot","grün");$a2=array("blau","gelb");$a3=array("orange","burgundy");print_r(array_replace($ a1,$a2,$a3));?>

Beispiel 4

Verwenden Sie numerische Schlüssel – wenn im zweiten Array array2 ein Schlüssel vorhanden ist, aber nicht im ersten Array array1, wird das Element im ersten Array array1 erstellt:

<?php$a1=array("rot",grün","blau","gelb");$a2=array(0=>"orange",3=>"burgundy");print_r(array_replace($ a1,$a2));?>