array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.array-replace.php', 1 => 'array_replace', 2 => 'Remplace les éléments d\'un tableau par ceux d\'autres tableaux', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Fonctions sur les tableaux', ), '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' => 'fr', '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 — Remplace les éléments d'un tableau par ceux d'autres tableaux

Description

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

array_replace() crée un nouveau tableau et y assigne des éléments pour chaque clé dans chacun des tableaux fournis. Si une clé apparaît dans plusieurs tableaux d'entrée, la valeur du tableau d'entrée le plus à droite sera utilisée.

array_replace() ne traite pas les éléments de manière récursive, il remplace la valeur entière pour chaque clé lorsqu'il effectue un remplacement.

Liste de paramètres

array

Le tableau dans lequel les éléments sont remplacés.

replacements

Tableaux depuis lesquels les éléments seront extraits. Les valeurs des futurs tableaux écraseront les valeurs précédentes.

Valeurs de retour

Retourne un tableau.

Exemples

Exemple #1 Exemple avec 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);
var_dump($basket);
?>

L'exemple ci-dessus va afficher :

array(5) {
  [0]=>
  string(5) "grape"
  [1]=>
  string(6) "banana"
  [2]=>
  string(5) "apple"
  [3]=>
  string(9) "raspberry"
  [4]=>
  string(6) "cherry"
}

Exemple #2 Exemple de gestion des tableaux imbriqués

<?php
$base = [ 'citrus' => [ 'orange', 'lemon' ], 'pome' => [ 'apple' ] ];
$replacements = [ 'citrus' => [ 'grapefruit' ] ];
$replacements2 = [ 'citrus' => [ 'kumquat', 'citron' ], 'pome' => [ 'loquat' ] ];

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

L'exemple ci-dessus va afficher :

array(2) {
  ["citrus"]=>
  array(2) {
    [0]=>
    string(7) "kumquat"
    [1]=>
    string(6) "citron"
  }
  ["pome"]=>
  array(1) {
    [0]=>
    string(6) "loquat"
  }
}

Voir aussi