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', 2 => 'Substitui elementos de arrays passados no primeiro array', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Funções para Array', ), 'prev' => array ( 0 => 'function.array-reduce.php', 1 => 'array_reduce', ), 'next' => array ( 0 => 'function.array-replace-recursive.php', 1 => 'array_replace_recursive', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/array/functions/array-replace.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

array_replace

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

array_replace — Substitui elementos de arrays passados no primeiro array

Descrição

array_replace(array $array, array ...$replacements): array

array_replace() cria um novo array e atribui itens a ele para cada chave em cada um dos arrays fornecidos. Se uma chave aparecer em múltiplos arrays de entrada, o valor do array de entrada mais à direita será usado.

array_replace() não processa os itens dos elementos recursivamente, ela substitui o valor inteiro para cada chave quando faz uma substituição.

Parâmetros

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.

Valor Retornado

Retorna um array.

Exemplos

Exemplo #1 Exemplo de array_replace()

<?php
$base = array("laranja", "banana", "maçã", "framboesa");
$substituicoes = array(0 => "abacaxi", 4 => "cereja");
$substituicoes2 = array(0 => "uva");

$cesta = array_replace($base, $substituicoes, $substituicoes2);
var_dump($cesta);
?>

O exemplo acima produzirá:

array(5) {
  [0]=>
  string(3) "uva"
  [1]=>
  string(6) "banana"
  [2]=>
  string(4) "maçã"
  [3]=>
  string(9) "framboesa"
  [4]=>
  string(6) "cereja"
}

Exemplo #2 Exemplo de como arrays aninhados são manipulados

<?php
$base = [ 'cítricas' => [ 'laranja', 'limão' ], 'pomóideas' => [ 'maçã' ] ];
$replacements = [ 'cítricas' => [ 'toranja' ] ];
$replacements2 = [ 'cítricas' => [ 'kumquat', 'cidra' ], 'pomóideas' => [ 'nêspera' ] ];

$cesta = array_replace($base, $substituicoes, $substituicoes2);
var_dump($cesta);
?>

O exemplo acima produzirá:

array(2) {
  ["cítricas"]=>
  array(2) {
    [0]=>
    string(7) "kumquat"
    [1]=>
    string(5) "cidra"
  }
  ["pomóideas"]=>
  array(1) {
    [0]=>
    string(7) "nêspera"
  }
}

Veja Também