# array_replace

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

array_replace — Reemplaza los elementos del array original con elementos de array adicionales

### Descripción

array_replace(array `$array1`, array `$...` = ?): array

array_replace() reemplaza los valores de `array1` con valores que tienen las mismas claves en cada uno de los siguientes arrays. Si la clave del primer array existe en el segundo array, su valor será reemplazado por el valor del segundo array. Si la clave existe en el segundo array y no en el primero, será creada en el primer array. Si la clave sólo existe en el primer array, se dejará como está. Si se proporcionan varios arrays para el reemplazo, se procederá en orden, los arrays posteriores sobrescribirán los valores anteriores.

array_replace() no es recursivo: reemplazará valores en el primer array por el tipo que esté en el segundo array.

### Parámetros

`array1`

  El array cuyos elementos son reemplazados.

`...`

  Arrays de los cuales se extraerán los elementos. Los valores de arrays posteriores sobrescriben los valores anteriores.

### Valores devueltos

Devuelve un array, o `null` en caso de error.

### Ejemplos

Ejemplo #1 Ejemplo de array_replace()

`<?php
$base = array("naranja", "plátano", "manzana", "frambuesa");
$reemplazos = array(0 => "piña", 4 => "cereza");
$reemplazos2 = array(0 => "uva");
$cesta = array_replace($base, $reemplazos, $reemplazos2);
print_r($cesta);
?>`

El resultado del ejemplo sería:

    Array
    (
        [0] => uva
        [1] => plátano
        [2] => manzana
        [3] => frambuesa
        [4] => cereza
    )

### Ver también

- array_replace_recursive() - Reemplaza los elementos de los arrays pasados al primer array de forma recursiva
- array_merge() - Combina dos o más arrays