array_replace_recursive
(PHP 5 >= 5.3.0)
array_replace_recursive — Replaces elements from passed arrays into the first array recursively
Description
$array
, array $array1
[, array $...
] )
array_replace_recursive() remplace les valeurs du premier
array
avec les valeurs des mêmes clés issues des
tableaux suivants. Si une clé du premier tableau existe dans un des
tableaux suivants, sa valeur sera remplacée. Si la clé n'existe pas
dans le premier tableau, elle sera créée. Si la clé n'existe que dans
le premier tableau, elle sera laissée intacte. Si plusieurs tableaux
sont passés comme arguments de remplacement, ils seront traités dans l'ordre.
array_replace_recursive() est récursive : si une valeur est un tableau, la même fonction de remplacement lui sera appliqué.
Si la valeur dans array
est scalaire, elle sera remplacée
par la valeur du tableau array1
, que ce soit un scalaire ou un
tableau. Si la valeur de array
et array1
sont toutes les deux des tableaux, array_replace_recursive() remplacera
les valeurs récursivement.
Liste de paramètres
-
array
-
Le tableau dans lequel les éléments sont remplacés.
-
array1
-
Les tableaux dont les valeurs finiront dans le premier tableau.
-
...
-
Optionnel. Plus de tableaux depuis lesquels les éléments peuvent être extraits.
Valeurs de retour
Retourne un tableau ou NULL
si une erreur survient.
Exemples
Exemple #1 Exemle avec array_replace_recursive()
<?php $base = array('citrus' => array( "orange") , 'berries' => array("blackberry", "raspberry"), ); $replacements = array('citrus' => array('pineapple'), 'berries' => array('blueberry')); $basket = array_replace_recursive($base, $replacements); print_r($basket); $basket = array_replace($base, $replacements); print_r($basket); ?>
<?php $base = array('citrus' => array("orange") , 'berries' => array("blackberry", "raspberry"), 'others' => 'banana' ); $replacements = array('citrus' => 'pineapple', 'berries' => array('blueberry'), 'others' => array('litchis')); $replacements2 = array('citrus' => array('pineapple'), 'berries' => array('blueberry'), 'others' => 'litchis'); $basket = array_replace_recursive($base, $replacements, $replacements2); print_r($basket); ?>
L'exemple ci-dessus va afficher :
Array ( [citrus] => Array ( [0] => pineapple ) [berries] => Array ( [0] => blueberry [1] => raspberry ) [others] => litchis )
Voir aussi
- array_replace() - Remplace les éléments d'un tableau par ceux d'autres tableaux
- array_merge_recursive() - Combine plusieurs tableaux ensemble, récursivement