(PHP 5 >= 5.3.0, PHP 7)
array_replace_recursive — Remplace récursivement dans le premier tableau les éléments des autres tableaux fournis
$array1
, array $array2
[, array $...
] )
array_replace_recursive() remplace les valeurs du tableau
array1 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 array1 est scalaire, elle sera remplacée
par la valeur du tableau array2, que ce soit un scalaire ou un
tableau. Si la valeur de array1 et array2
sont toutes les deux des tableaux, array_replace_recursive() remplacera
les valeurs récursivement.
array1Le tableau dans lequel les éléments sont remplacés.
array2Les tableaux dont les valeurs finiront dans le premier tableau.
...Optionnel. Plus de tableaux depuis lesquels les éléments peuvent être extraits.
Retourne un tableau ou NULL si une erreur survient.
Exemple #1 Exemple 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);
?>
L'exemple ci-dessus va afficher :
Array
(
[citrus] => Array
(
[0] => pineapple
)
[berries] => Array
(
[0] => blueberry
[1] => raspberry
)
)
Array
(
[citrus] => Array
(
[0] => pineapple
)
[berries] => Array
(
[0] => blueberry
)
)
Exemple #2 Exemple avec array_replace_recursive() et la récursivité
<?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
)