Função array_replace() do PHP

Exemplo

Substituir os valores da primeira matriz usando os valores da segunda matriz ($a2):

<?php
$a1=array("red","green");
$a2=array("blue","yellow");
print_r(array_replace($a1,$a2));
?>

Executar exemplo

Definição e uso

A função array_replace() substitui os valores da primeira matriz pelos valores da matriz subsequente.

Dica:Você pode passar um array para a função, ou múltiplos arrays.

se uma chave existir na primeira matriz array1 também existir na segunda matriz array2a primeira matriz array1 será substituída pela matriz array2 substituir os valores. Se uma chave existir apenas na primeira matriz array1manterá-se inalterada. (Veja o exemplo a seguir 1)

se uma chave existir na segunda matriz array2mas não existir na primeira matriz array1se existir na primeira matriz array1 criar este elemento. (Veja o exemplo a seguir 2)

Se vários arrays de substituição forem passados, eles serão processados em ordem consecutiva, e os valores da matriz subsequente substituirão os valores da matriz anterior. (Veja o exemplo a seguir 3)

Dica:Use array_replace_recursive() usando os valores da matriz subsequente para substituir os valores da primeira matriz recursivamente.

Sintaxe

array_replace(array1,array2,array3...)
Parâmetros Descrição
array1 obrigatório. Especificar uma matriz.
array2 opcional. Especificar valores a serem substituídos array1 uma matriz de valores.
array3,... opcional. Especificar múltiplos valores a serem substituídos array1 e array2do valor de ..., uma matriz de valores. Os valores da matriz subsequente substituirão os valores da matriz anterior.

Detalhes técnicos

Retorno: Retorna o array substituído, se ocorrer um erro, retorna NULL.
Versão PHP: 5.3.0+

Mais exemplos

Exemplo 1

Se uma chave existe array1 também existe array2 Neste caso, o valor da primeira array será substituído pelo valor da segunda array:

<?php
$a1=array("a"=>"red","b"=>"green");
$a2=array("a"=>"orange","burgundy");
print_r(array_replace($a1,$a2));
?>

Executar exemplo

Exemplo 2

Se uma chave existe apenas na segunda array:

<?php
$a1=array("a"=>"red","green");
$a2=array("a"=>"orange","b"=>"burgundy");
print_r(array_replace($a1,$a2));
?>

Executar exemplo

Exemplo 3

Uso de três arrays - O último array ($a3) cobrirá os arrays anteriores ($a1 e $a2):

<?php
$a1=array("red","green");
$a2=array("blue","yellow");
$a3=array("orange","burgundy");
print_r(array_replace($a1,$a2,$a3));
?>

Executar exemplo

Exemplo 4

Uso de chaves numéricas - Se uma chave existe apenas na segunda array e não na primeira:

<?php
$a1=array("red","green","blue","yellow");
$a2=array(0=>"orange",3=>"burgundy");
print_r(array_replace($a1,$a2));
?>

Executar exemplo