<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.array.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'it',
  ),
  'this' => 
  array (
    0 => 'function.array-replace-recursive.php',
    1 => 'array_replace_recursive',
    2 => 'Replaces elements from passed arrays into the first array recursively',
  ),
  'up' => 
  array (
    0 => 'ref.array.php',
    1 => 'Array Funzioni',
  ),
  'prev' => 
  array (
    0 => 'function.array-replace.php',
    1 => 'array_replace',
  ),
  'next' => 
  array (
    0 => 'function.array-reverse.php',
    1 => 'array_reverse',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'en',
    'path' => 'reference/array/functions/array-replace-recursive.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.array-replace-recursive" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">array_replace_recursive</h1>
  <p class="verinfo">(PHP 5 &gt;= 5.3.0, PHP 7, PHP 8)</p><p class="refpurpose"><span class="refname">array_replace_recursive</span> &mdash; <span class="dc-title">Replaces elements from passed arrays into the first array recursively</span></p>

 </div>
 <div class="refsect1 description" id="refsect1-function.array-replace-recursive-description">
  <h3 class="title">Descrizione</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>array_replace_recursive</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.array.php" class="type array">array</a></span> <code class="parameter">$array</code></span>, <span class="methodparam"><span class="type"><a href="language.types.array.php" class="type array">array</a></span> <code class="parameter">...$replacements</code></span>): <span class="type"><a href="language.types.array.php" class="type array">array</a></span></div>

  <p class="para rdfs-comment">
   <span class="function"><strong>array_replace_recursive()</strong></span> replaces the values of
   <code class="parameter">array</code> with the same values from all the following
   arrays. If a key from the first array exists in the second array, its value
   will be replaced by the value from the second array. If the key exists in the
   second array, and not the first, it will be created in the first array.
   If a key only exists in the first array, it will be left as is. 
   If several arrays are passed for replacement, they will be processed
   in order, the later array overwriting the previous values.
  </p>
  <p class="para">
   <span class="function"><strong>array_replace_recursive()</strong></span> is recursive : it will recurse into
   arrays and apply the same process to the inner value.
  </p>
  <p class="para">
   When the value in the first array is scalar, it will be replaced
   by the value in the second array, may it be scalar or array.
   When the value in the first array and the second array
   are both arrays, <span class="function"><strong>array_replace_recursive()</strong></span> will replace
   their respective value recursively.
  </p>
 </div>

 <div class="refsect1 parameters" id="refsect1-function.array-replace-recursive-parameters">
  <h3 class="title">Elenco dei parametri</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">array</code></dt>
     <dd>
      <p class="para">
       The array in which elements are replaced.
      </p>
     </dd>
    
    
     <dt><code class="parameter">replacements</code></dt>
     <dd>
      <p class="para">
       Arrays from which elements will be extracted.
      </p>
     </dd>
    
   </dl>
  </p>
 </div>

 <div class="refsect1 returnvalues" id="refsect1-function.array-replace-recursive-returnvalues">
  <h3 class="title">Valori restituiti</h3>
  <p class="para">
   Returns an <span class="type"><a href="language.types.array.php" class="type array">array</a></span>.
  </p>
 </div>

 <div class="refsect1 examples" id="refsect1-function.array-replace-recursive-examples">
  <h3 class="title">Esempi</h3>
  <p class="para">
   <div class="example" id="example-1">
    <p><strong>Example #1 <span class="function"><strong>array_replace_recursive()</strong></span> example</strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$base </span><span style="color: #007700">= array(</span><span style="color: #DD0000">'citrus' </span><span style="color: #007700">=&gt; array(</span><span style="color: #DD0000">"orange"</span><span style="color: #007700">), </span><span style="color: #DD0000">'berries' </span><span style="color: #007700">=&gt; array(</span><span style="color: #DD0000">"blackberry"</span><span style="color: #007700">, </span><span style="color: #DD0000">"raspberry"</span><span style="color: #007700">));<br /></span><span style="color: #0000BB">$replacements </span><span style="color: #007700">= array(</span><span style="color: #DD0000">'citrus' </span><span style="color: #007700">=&gt; array(</span><span style="color: #DD0000">'pineapple'</span><span style="color: #007700">), </span><span style="color: #DD0000">'berries' </span><span style="color: #007700">=&gt; array(</span><span style="color: #DD0000">'blueberry'</span><span style="color: #007700">));<br /><br /></span><span style="color: #0000BB">$basket </span><span style="color: #007700">= </span><span style="color: #0000BB">array_replace_recursive</span><span style="color: #007700">(</span><span style="color: #0000BB">$base</span><span style="color: #007700">, </span><span style="color: #0000BB">$replacements</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">print_r</span><span style="color: #007700">(</span><span style="color: #0000BB">$basket</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">$basket </span><span style="color: #007700">= </span><span style="color: #0000BB">array_replace</span><span style="color: #007700">(</span><span style="color: #0000BB">$base</span><span style="color: #007700">, </span><span style="color: #0000BB">$replacements</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">print_r</span><span style="color: #007700">(</span><span style="color: #0000BB">$basket</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

    <div class="example-contents"><p>Il precedente esempio visualizzerà:</p></div>
    <div class="example-contents screen">
<div class="examplescode"><pre class="examplescode">Array
(
    [citrus] =&gt; Array
        (
            [0] =&gt; pineapple
        )

    [berries] =&gt; Array
        (
            [0] =&gt; blueberry
            [1] =&gt; raspberry
        )

)
Array
(
    [citrus] =&gt; Array
        (
            [0] =&gt; pineapple
        )

    [berries] =&gt; Array
        (
            [0] =&gt; blueberry
        )

)</pre>
</div>
    </div>
   </div>
   <div class="example" id="example-2">
    <p><strong>Example #2 <span class="function"><strong>array_replace_recursive()</strong></span> and recursive behavior</strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$base </span><span style="color: #007700">= array(</span><span style="color: #DD0000">'citrus' </span><span style="color: #007700">=&gt; array(</span><span style="color: #DD0000">"orange"</span><span style="color: #007700">) , </span><span style="color: #DD0000">'berries' </span><span style="color: #007700">=&gt; array(</span><span style="color: #DD0000">"blackberry"</span><span style="color: #007700">, </span><span style="color: #DD0000">"raspberry"</span><span style="color: #007700">), </span><span style="color: #DD0000">'others' </span><span style="color: #007700">=&gt; </span><span style="color: #DD0000">'banana' </span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$replacements </span><span style="color: #007700">= array(</span><span style="color: #DD0000">'citrus' </span><span style="color: #007700">=&gt; </span><span style="color: #DD0000">'pineapple'</span><span style="color: #007700">, </span><span style="color: #DD0000">'berries' </span><span style="color: #007700">=&gt; array(</span><span style="color: #DD0000">'blueberry'</span><span style="color: #007700">), </span><span style="color: #DD0000">'others' </span><span style="color: #007700">=&gt; array(</span><span style="color: #DD0000">'litchis'</span><span style="color: #007700">));<br /></span><span style="color: #0000BB">$replacements2 </span><span style="color: #007700">= array(</span><span style="color: #DD0000">'citrus' </span><span style="color: #007700">=&gt; array(</span><span style="color: #DD0000">'pineapple'</span><span style="color: #007700">), </span><span style="color: #DD0000">'berries' </span><span style="color: #007700">=&gt; array(</span><span style="color: #DD0000">'blueberry'</span><span style="color: #007700">), </span><span style="color: #DD0000">'others' </span><span style="color: #007700">=&gt; </span><span style="color: #DD0000">'litchis'</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">$basket </span><span style="color: #007700">= </span><span style="color: #0000BB">array_replace_recursive</span><span style="color: #007700">(</span><span style="color: #0000BB">$base</span><span style="color: #007700">, </span><span style="color: #0000BB">$replacements</span><span style="color: #007700">, </span><span style="color: #0000BB">$replacements2</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">print_r</span><span style="color: #007700">(</span><span style="color: #0000BB">$basket</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

    <div class="example-contents"><p>Il precedente esempio visualizzerà:</p></div>
    <div class="example-contents screen">
<div class="examplescode"><pre class="examplescode">Array
(
    [citrus] =&gt; Array
        (
            [0] =&gt; pineapple
        )

    [berries] =&gt; Array
        (
            [0] =&gt; blueberry
            [1] =&gt; raspberry
        )

    [others] =&gt; litchis
)</pre>
</div>
    </div>
   </div>
  </p>
 </div>

 <div class="refsect1 seealso" id="refsect1-function.array-replace-recursive-seealso">
  <h3 class="title">Vedere anche:</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="function"><a href="function.array-replace.php" class="function" rel="rdfs-seeAlso">array_replace()</a> - Replaces elements from passed arrays into the first array</span></li>
    <li><span class="function"><a href="function.array-merge-recursive.php" class="function" rel="rdfs-seeAlso">array_merge_recursive()</a> - Fonde due o pi&ugrave; array in modo ricorsivo</span></li>
   </ul>
  </p>
 </div>

</div><?php manual_footer($setup); ?>