function.array-diff-assoc.html 10.1 KB
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>Berechnet den Unterschied zwischen Arrays mit zus&auml;tzlicher
   Indexpr&uuml;fung</title>

 </head>
 <body><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="function.array-count-values.html">array_count_values</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="function.array-diff-key.html">array_diff_key</a></div>
 <div class="up"><a href="ref.array.html">Array Funktionen</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="function.array-diff-assoc" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">array_diff_assoc</h1>
  <p class="verinfo">(PHP 4 &gt;= 4.3.0, PHP 5)</p><p class="refpurpose"><span class="refname">array_diff_assoc</span> &mdash; <span class="dc-title">
   Berechnet den Unterschied zwischen Arrays mit zusätzlicher
   Indexprüfung
  </span></p>

 </div>

 <div class="refsect1 description" id="refsect1-function.array-diff-assoc-description">
  <h3 class="title">Beschreibung</h3>
  <div class="methodsynopsis dc-description">
   <span class="type">array</span> <span class="methodname"><strong>array_diff_assoc</strong></span>
    ( <span class="methodparam"><span class="type">array</span> <code class="parameter">$array1</code></span>
   , <span class="methodparam"><span class="type">array</span> <code class="parameter">$array2</code></span>
   [, <span class="methodparam"><span class="type">array</span> <code class="parameter">$...</code></span>
  ] )</div>

  <p class="para rdfs-comment">
   Vergleicht <code class="parameter">array1</code> mit <code class="parameter">array2</code> und
   gibt den Unterschied zurück. Im Gegensatz zu <span class="function"><a href="function.array-diff.html" class="function">array_diff()</a></span>
   werden die Schlüssel des Arrays ebenfalls beim Vergleich herangezogen.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.array-diff-assoc-parameters">
  <h3 class="title">Parameter-Liste</h3>
  <p class="para">
   <dl>


    
     <dt>
<code class="parameter">array1</code></dt>

     <dd>

      <p class="para">
       Das Array, das verglichen werden soll
      </p>
     </dd>

    

    
     <dt>
<code class="parameter">array2</code></dt>

     <dd>

      <p class="para">
       Das Array, mit dem verglichen werden soll
      </p>
     </dd>

    

    
     <dt>
<code class="parameter">...</code></dt>

     <dd>

      <p class="para">
       Weitere Arrays, mit denen vergleichen werden soll
      </p>
     </dd>

    

   </dl>

  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.array-diff-assoc-returnvalues">
  <h3 class="title">Rückgabewerte</h3>
  <p class="para">
   Gibt ein <span class="type"><a href="language.types.array.html" class="type Array">Array</a></span> zurück, das alle Werte aus 
   <code class="parameter">array1</code> enthält, die in keinem der
   anderen Arrays vorhanden ist. 
  </p>
 </div>




 <div class="refsect1 examples" id="refsect1-function.array-diff-assoc-examples">
  <h3 class="title">Beispiele</h3>
  <p class="para">
   <div class="example" id="example-4896">
    <p><strong>Beispiel #1 <span class="function"><strong>array_diff_assoc()</strong></span>-Beispiel</strong></p>
    <div class="example-contents"><p>
     In diesem Beispiel sieht man, dass das
     <em>&quot;a&quot; =&gt; &quot;gruen&quot;</em>-Paar in beiden Arrays enthalten ist
     und daher nicht in der Ausgabe der Funktion auftaucht. Andererseits ist das
     Paar <em>0 =&gt; &quot;rot&quot;</em> in der Ausgabe, weil
     <em>&quot;red&quot;</em> im zweiten Array den Wert
     <em>1</em> enthält.
    </p></div>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br />$array1&nbsp;</span><span style="color: #007700">=&nbsp;array(</span><span style="color: #DD0000">"a"&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #DD0000">"gruen"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"b"&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #DD0000">"braun"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"c"&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #DD0000">"blau"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"rot"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$array2&nbsp;</span><span style="color: #007700">=&nbsp;array(</span><span style="color: #DD0000">"a"&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #DD0000">"gruen"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"gelb"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"rot"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$result&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">array_diff_assoc</span><span style="color: #007700">(</span><span style="color: #0000BB">$array1</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">$array2</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">print_r</span><span style="color: #007700">(</span><span style="color: #0000BB">$result</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</code></div>
    </div>

    <div class="example-contents"><p>Das oben gezeigte Beispiel erzeugt folgende
Ausgabe:</p></div>
    <div class="example-contents screen">
<div class="cdata"><pre>
Array
(
    [b] =&gt; braun
    [c] =&gt; blau
    [0] =&gt; rot
)
</pre></div>
    </div>
   </div>
  </p>
  <p class="para">
   <div class="example" id="example-4897">
    <p><strong>Beispiel #2 <span class="function"><strong>array_diff_assoc()</strong></span>-Beispiel</strong></p>
    <div class="example-contents"><p>
     Zwei Werte von <em class="emphasis">Schlüssel =&gt; Wert</em>-Paaren werden nur
     dann als gleich betrachtet, wenn <em>(string) $elem1 === (string)
     $elem2 </em> gilt. Anders ausgedrückt findet eine strikte Prüfung statt,
     in der die String-Repräsentationen gleich sein müssen.
    </p></div>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br />$array1&nbsp;</span><span style="color: #007700">=&nbsp;array(</span><span style="color: #0000BB">0</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">1</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">2</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$array2&nbsp;</span><span style="color: #007700">=&nbsp;array(</span><span style="color: #DD0000">"00"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"01"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"2"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$result&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">array_diff_assoc</span><span style="color: #007700">(</span><span style="color: #0000BB">$array1</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">$array2</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">print_r</span><span style="color: #007700">(</span><span style="color: #0000BB">$result</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</code></div>
    </div>

    <div class="example-contents"><p>Das oben gezeigte Beispiel erzeugt folgende
Ausgabe:</p></div>
    <div class="example-contents screen">
<div class="cdata"><pre>
Array
(
    [0] =&gt; 0
    [1] =&gt; 1
    )
</pre></div>
    </div>
   </div>
  </p>
 </div>


 <div class="refsect1 notes" id="refsect1-function.array-diff-assoc-notes">
  <h3 class="title">Anmerkungen</h3>
  <blockquote class="note"><p><strong class="note">Hinweis</strong>: 
   <span class="simpara">
    Diese Funktion überprüft nur eine Dimension eines
    n-dimensionalen Arrays. Natürlich kann man tiefere Dimensionen
    überprüfen, indem man zum Beispiel
    <em>array_diff_assoc($array1[0], $array2[0]);</em> verwendet.
   </span>
  </p></blockquote>
  <blockquote class="note"><p><strong class="note">Hinweis</strong>: 
   <span class="simpara">
    Stellen Sie sicher, dass Sie die Parameter in der korrekten Reihenfolge
    übergeben, wenn Sie mit ähnlichen Arrays mit mehr Schlüsseln vergleichen.
    Das neue Array sollte das erste in der Liste sein.
   </span>
  </p></blockquote>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.array-diff-assoc-seealso">
  <h3 class="title">Siehe auch</h3>
  <p class="para">
   <ul class="simplelist">
    <li class="member"><span class="function"><a href="function.array-diff.html" class="function" rel="rdfs-seeAlso">array_diff()</a> - Ermittelt die Unterschiede zwischen Arrays</span></li>
    <li class="member"><span class="function"><a href="function.array-intersect.html" class="function" rel="rdfs-seeAlso">array_intersect()</a> - Ermittelt die Schnittmenge von Arrays</span></li>
    <li class="member"><span class="function"><a href="function.array-intersect-assoc.html" class="function" rel="rdfs-seeAlso">array_intersect_assoc()</a> - Ermittelt die Schnittmenge von Arrays mit Indexpr&uuml;fung</span></li>
   </ul>
  </p>
 </div>


</div><hr /><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="function.array-count-values.html">array_count_values</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="function.array-diff-key.html">array_diff_key</a></div>
 <div class="up"><a href="ref.array.html">Array Funktionen</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>