array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.array-replace.php', 1 => 'array_replace', 2 => 'Ersetzt Elemente von übergebenen Arrays im ersten Array', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Array Funktionen', ), 'prev' => array ( 0 => 'function.array-reduce.php', 1 => 'array_reduce', ), 'next' => array ( 0 => 'function.array-replace-recursive.php', 1 => 'array_replace_recursive', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/array/functions/array-replace.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

array_replace

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

array_replace — Ersetzt Elemente von übergebenen Arrays im ersten Array

Beschreibung

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

array_replace() erstellt ein neues Array und fügt für jeden Schlüssel aus den übergebenen Arrays die entsprechenden Elemente hinzu. Wenn ein Schlüssel in mehreren der übergebenen Arrays existiert, wird der Wert des Schlüssels aus dem weiter rechts stehenden Array übernommen.

array_replace() verarbeitet die Elemente nicht rekursiv, sondern ersetzt bei jeder Ersetzung den Wert jedes Schlüssels vollständig.

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);
var_dump($basket);
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

array(5) {
  [0]=>
  string(5) "Traube"
  [1]=>
  string(6) "Banane"
  [2]=>
  string(5) "Apfel"
  [3]=>
  string(9) "Himbeere"
  [4]=>
  string(6) "Kirsche"
}

Beispiel #2 Beispiel für die Behandlung von verschachtelten Arrays

<?php
$base = [ 'Zitrusfrüchte' => [ 'Orange', 'Zitrone' ], 'Kernobst' => [ 'Apfel' ] ];
$replacements = [ 'Zitrusfrüchte' => [ 'Grapefruit' ] ];
$replacements2 = [ 'Zitrusfrüchte' => [ 'Kumquat', 'Zitronatzitrone' ], 'Kernobst' => [ 'Loquat' ] ];

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

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

array(2) {
  ["Zitrusfrüchte"]=>
  array(2) {
    [0]=>
    string(7) "Kumquat"
    [1]=>
    string(6) "Zitronatzitrone"
  }
  ["Kernobst"]=>
  array(1) {
    [0]=>
    string(6) "Loquat"
  }
}

Siehe auch