array_replace_recursive

(PHP 5 >= 5.3.0, PHP 7)

array_replace_recursiveРекурсивно заменяет элементы первого массива элементами переданных массивов

Описание

array array_replace_recursive ( array $array1 , array $array2 [, array $... ] )

array_replace_recursive() заменяет значения массива array1 на соответствующие по ключам значения из всех следующих массивов. Если ключ из первого массива есть во втором, его значение будет заменено на значение из второго массива. Если ключ есть во втором массиве, но отсутствует в первом, он будет создан в первом массиве. Если ключ есть только в первом массиве, то он остается как есть. Если передано несколько массивов, они будут обработаны по порядку, последующие перезаписывают предыдущие значения.

array_replace_recursive() - рекурсивная функция: она будет рекурсивно углубляться в массивы и применять к всем внутренним значениям один и тот же процесс.

Если значение, переданное в array1 является скалярным, оно будет заменено значением в array2, которое может быть как скалярным так и массивом. Если оба значения, переданные в array1 и array2 - массивы, array_replace_recursive() будет заменять их значения рекурсивно.

Список параметров

array1

Массив, элементы которого будут заменены.

array2

Массив, из которого будут взяты элементы для замены.

...

Дополнительные массивы, из которых будут браться элементы для замены.

Возвращаемые значения

Возвращает array, или NULL, если произошла ошибка.

Примеры

Пример #1 Пример использования 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);
?>

Результат выполнения данного примера:

Array
(
    [citrus] => Array
        (
            [0] => pineapple
        )

    [berries] => Array
        (
            [0] => blueberry
            [1] => raspberry
        )

)
Array
(
    [citrus] => Array
        (
            [0] => pineapple
        )

    [berries] => Array
        (
            [0] => blueberry
        )

)

Пример #2 array_replace_recursive() and recursive behavior

<?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);

?>

Результат выполнения данного примера:

Array
(
    [citrus] => Array
        (
            [0] => pineapple
        )

    [berries] => Array
        (
            [0] => blueberry
            [1] => raspberry
        )

    [others] => litchis
)

Смотрите также

  • array_replace() - Замена элементов массива элементами других переданных массивов
  • array_merge_recursive() - Рекурсивное слияние двух или более массивов

Коментарии

Автор:
Note that function will NOT replace a sub-tree from you $array1 if its value in $array2 is an empty array. 
Even tho the key for this dimension is technically 'set'. 

(I suppose it treats it as just another recursive level to dive in, finding no key to compare, backtracking while leaving this sub-tree alone)

For example:

$array1  = ['first' => ['second' => 'hello']];
$array2  = ['first' => []];             
$result = array_replace_recursive($array1, $array2);

$result is still: ['first' => ['second' => 'hello']].
2020-02-10 19:14:11
http://php5.kiev.ua/manual/ru/function.array-replace-recursive.html

    Поддержать сайт на родительском проекте КГБ