Función PHP array_replace()

Ejemplo

Reemplace los valores de la primera matriz ($a1) con los valores de la segunda matriz ($a2):

<?php$a1=array("rojo","verde");$a2=array("azul","amarillo");print_r(array_replace($a1,$a2));?>

Definición y uso

La función array_replace() reemplaza los valores de la primera matriz con los valores de la siguiente matriz.

Consejo: Puede pasar una matriz o varias matrices a la función.

Si existe una clave en la primera matriz matriz1 y también existe en la segunda matriz matriz2, el valor de la primera matriz matriz1 será reemplazado por el valor de la segunda matriz matriz2. Si una clave solo existe en la primera matriz array1, permanecerá sin cambios. (Consulte el Ejemplo 1 a continuación para obtener más detalles)

Si existe una clave en la segunda matriz, matriz2, pero no en la primera matriz, matriz1, el elemento se creará en la primera matriz, matriz1. (Consulte el Ejemplo 2 a continuación para obtener más detalles)

Si se pasan varias matrices de reemplazo, se procesarán en orden y los valores de las matrices posteriores sobrescribirán los valores de las matrices anteriores. (Consulte el Ejemplo 3 a continuación para obtener más detalles)

Consejo: utilice array_replace_recursive() para reemplazar recursivamente los valores de la primera matriz con los valores de las matrices posteriores.

gramática

 matriz_reemplazar ( matriz1,matriz2,matriz3... )

parámetro	describir
matriz1	Requerido. Especifique una matriz.
matriz2	Opcional. Especifica una matriz para reemplazar el valor de matriz1 .
matriz3,...	Opcional. Especifique varias matrices para reemplazar los valores de matriz1 y matriz2, .... Los valores de la siguiente matriz sobrescribirán los valores de la matriz anterior.

detalles tecnicos

Valor de retorno:	Devuelve la matriz reemplazada o NULL si se produce un error.
Versión PHP:	5.3.0+

Más ejemplos

Ejemplo 1

Si existe una clave en la primera matriz matriz1 y también existe en la segunda matriz matriz2, el valor de la primera matriz matriz1 será reemplazado por el valor de la segunda matriz matriz2. Si una clave solo existe en la primera matriz array1, permanecerá sin cambios.

<?php$a1=array("a"=>"rojo","b"=>"verde");$a2=array("a"=>"naranja","burdeos");print_r(array_replace( $a1,$a2));?>

Ejemplo 2

Si existe una clave en la segunda matriz, matriz2, pero no en la primera matriz, matriz1, el elemento se creará en la primera matriz, matriz1.

<?php$a1=array("a"=>"rojo","verde");$a2=array("a"=>"naranja","b"=>"burdeos");print_r(array_replace( $a1,$a2));?>

Ejemplo 3

Usando tres matrices, la última matriz ($a3) sobrescribirá las matrices anteriores ($a1 y $a2):

<?php$a1=array("rojo","verde");$a2=array("azul","amarillo");$a3=array("naranja","burdeos");print_r(array_replace($ a1,$a2,$a3));?>

Ejemplo 4

Utilice claves numéricas: si existe una clave en la segunda matriz array2, pero no en la primera matriz array1, el elemento se creará en la primera matriz array1:

<?php$a1=array("rojo","verde","azul","amarillo");$a2=array(0=>"naranja",3=>"burdeos");print_r(array_replace($ a1,$a2));?>