array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.array-replace.php', 1 => 'array_replace', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Funções para Array', ), 'prev' => array ( 0 => 'function.array-replace-recursive.php', 1 => 'array_replace_recursive', ), 'next' => array ( 0 => 'function.array-reverse.php', 1 => 'array_reverse', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/array/functions/array-replace.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 5 >= 5.3.0, PHP 7, PHP 8)
array_replace — Substitui elementos de arrays passados no primeiro array
array_replace() substitui os valores de
array
por valores com as mesmas keys em cada um dos seguintes
arrays. Se uma key do primeiro array existir no segundo array, seu valor
será substituído pelo valor do segundo array. Se a key existir no segundo array,
e não no primeiro, ela será criada no primeiro array.
Se uma key existir apenas na primeira matriz, ela será deixada como está.
Se vários arrays forem passados para substituição, eles serão processados em
ordem, os arrays posteriores sobrescrevendo os valores anteriores.
array_replace() não é recursivo: substituirá os valores no primeiro array por qualquer tipo que esteja no segundo array.
array
O array no qual os elementos são substituídos.
replacements
Arrays dos quais os elementos serão extraídos. Os valores dos arrays posteriores substituem os valores anteriores.
Retorna um array.
Exemplo #1 array_replace() exemplo
<?php
$base = array("laranja", "banana", "maçã", "framboesa");
$substituicoes = array(0 => "abacaxi", 4 => "cereja");
$substituicoes2 = array(0 => "uva");
$cesta = array_replace($base, $substituicoes, $substituicoes2);
print_r($cesta);
?>
O exemplo acima produzirá:
Array ( [0] => uva [1] => banana [2] => maçã [3] => framboesa [4] => cereja )