Função PHP array_replace()
Exemplo
Substitua os valores do primeiro array ($a1) pelos valores do segundo array ($a2):
<?php
$a1=array("red","green");
$a2=array("blue","yellow");
print_r(array_replace($a1,$a2));
?>
Definição e uso
A função array_replace() substitui os valores do primeiro array pelos valores dos arrays seguintes.
Dica: Você pode atribuir uma matriz à função ou quantas desejar.
Se uma chave de array1 existir em array2, os valores de array1 serão substituídos pelos valores de array2. Se a chave existir apenas em array1, ela será deixada como está (veja o Exemplo 1 abaixo).
Se existir uma chave em array2 e não em array1, ela será criada em array1 (veja o Exemplo 2 abaixo).
Se vários arrays forem usados, os valores dos arrays posteriores substituirão os anteriores (veja o Exemplo 3 abaixo).
Dica: Use array_replace_recursive() para substituir os valores de array1 pelos valores dos seguintes arrays recursivamente.
Sintaxe
array_replace(array1, array2, array3, ...)
Valores de parâmetro
Parameter | Description |
---|---|
array1 | Required. Specifies an array |
array2 | Optional. Specifies an array which will replace the values of array1 |
array3,... | Optional. Specifies more arrays to replace the values of array1 and array2, etc. Values from later arrays will overwrite the previous ones. |
Detalhes técnicos
Valor de retorno: | Retorna o array substituído ou NULL se ocorrer um erro |
---|---|
Versão do PHP: | 5.3.0+ |
Mais exemplos
Exemplo 1
Se uma chave de array1 existir em array2 e se a chave existir apenas em array1:
<?php
$a1=array("a"=>"red","b"=>"green");
$a2=array("a"=>"orange","burgundy");
print_r(array_replace($a1,$a2));
?>
Exemplo 2
Se existe uma chave em array2 e não em array1:
<?php
$a1=array("a"=>"red","green");
$a2=array("a"=>"orange","b"=>"burgundy");
print_r(array_replace($a1,$a2));
?>
Exemplo 3
Usando três arrays - o último array ($a3) substituirá os anteriores ($a1 e $a2):
<?php
$a1=array("red","green");
$a2=array("blue","yellow");
$a3=array("orange","burgundy");
print_r(array_replace($a1,$a2,$a3));
?>
Exemplo 4
Usando chaves numéricas - Se existe uma chave em array2 e não em array1:
<?php
$a1=array("red","green","blue","yellow");
$a2=array(0=>"orange",3=>"burgundy");
print_r(array_replace($a1,$a2));
?>
❮ Referência de array PHP