Fonction array_replace() de PHP

❮ Référence des tableaux PHP

Exemple

Remplacez les valeurs du premier tableau ($a1) par celles du deuxième tableau ($a2) :

<?php
$a1=array("rouge","vert");
$a2=array("bleu","jaune");
print_r(array_replace($a1,$a2));
?>
Essayez-le vous-même »

Définition et Utilisation

La fonction array_replace() remplace les valeurs du premier tableau par celles des tableaux suivants.

Astuce : Vous pouvez passer un tableau à la fonction, ou autant que vous le souhaitez.

Si une clé de array1 existe dans array2, les valeurs de array1 seront remplacées par celles de array2. Si la clé n'existe que dans array1, elle restera inchangée (voir Exemple 1 ci-dessous).

Si une clé existe dans array2 et pas dans array1, elle sera ajoutée à array1 (voir Exemple 2 ci-dessous).

Si plusieurs tableaux sont utilisés, les valeurs des tableaux suivants écraseront celles des précédents (voir Exemple 3 ci-dessous).

Astuce : Utilisez array_replace_recursive() pour remplacer les valeurs de array1 par celles des tableaux suivants de manière récursive.


Syntaxe

array_replace( array1, array2, array3, ... )

Valeurs des Paramètres

Paramètre Description
array1 Requis. Spécifie un tableau
array2 Optionnel. Spécifie un tableau qui remplacera les valeurs de array1
array3,... Optionnel. Spécifie d'autres tableaux pour remplacer les valeurs de array1 et array2, etc. Les valeurs des tableaux suivants écraseront les précédentes.


Détails Techniques

Valeur de Retour : Renvoie le tableau remplacé, ou NULL si une erreur se produit
Version PHP : 5.3.0+

Plus d'Exemples

Exemple 1

Si une clé de array1 existe dans array2, et si la clé n'existe que dans array1 :

<?php
$a1=array("a"=>"rouge","b"=>"vert");
$a2=array("a"=>"orange","bourgogne");
print_r(array_replace($a1,$a2));
?>
Essayez-le vous-même »

Exemple 2

Si une clé existe dans array2 et pas dans array1 :

<?php
$a1=array("a"=>"rouge","vert");
$a2=array("a"=>"orange","b"=>"bourgogne");
print_r(array_replace($a1,$a2));
?>
Essayez-le vous-même »

Exemple 3

Utilisation de trois tableaux - le dernier tableau ($a3) écrasera les précédents ($a1 et $a2) :

<?php
$a1=array("rouge","vert");
$a2=array("bleu","jaune");
$a3=array("orange","bourgogne");
print_r(array_replace($a1,$a2,$a3));
?>
Essayez-le vous-même »

Exemple 4

Utilisation de clés numériques - Si une clé existe dans array2 et pas dans array1 :

<?php
$a1=array("rouge","vert","bleu","jaune");
$a2=array(0=>"orange",3=>"bourgogne");
print_r(array_replace($a1,$a2));
?>
Essayez-le vous-même »

❮ Référence des tableaux PHP