array_replace
(PHP 5 >= 5.3.0, PHP 7)
array_replace — Заменяет элементы массива элементами других переданных массивов
Описание
$array
, array ...$replacements
) : array
array_replace() замещает значения массива
array значениями с такими же ключами из
других переданных массивов. Если ключ из первого массива присутствует
во втором массиве, его значение заменяется на значение из второго массива.
Если ключ есть во втором массиве, но отсутствует в первом - он будет создан
в первом массиве. Если ключ присутствует только в первом массиве, то
сохранится как есть. Если для замены передано несколько массивов, они
будут обработаны в порядке передачи и последующие массивы будут
перезаписывать значения из предыдущих.
array_replace() не рекурсивная: значения первого массива будут заменены вне зависимости от типа значений второго массива, даже если это будут вложенные массивы.
Список параметров
-
array -
Массив, элементы которого требуется заменить.
-
replacements -
Массивы, из которых будут браться элементы для замены. Значения следующего массива затирают значения предыдущего.
Возвращаемые значения
Возвращает массив (array) или null в случае ошибки.
Примеры
Пример #1 Пример использования 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);
print_r($basket);
?>
Результат выполнения данного примера:
Array
(
[0] => grape
[1] => banana
[2] => apple
[3] => raspberry
[4] => cherry
)
Смотрите также
- array_replace_recursive() - Рекурсивно заменяет элементы первого массива элементами переданных массивов
- array_merge() - Сливает один или большее количество массивов