archived-doc-de/reference/array/functions/array-diff-assoc.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2762980ae4b6b79f5223a5c9f7ff7911c7e8105d Maintainer: simp Status: ready -->
<refentry xml:id="function.array-diff-assoc" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>array_diff_assoc</refname>
  <refpurpose>
   Berechnet den Unterschied zwischen Arrays mit zusätzlicher
   Indexprüfung
  </refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>array</type><methodname>array_diff_assoc</methodname>
   <methodparam><type>array</type><parameter>array</parameter></methodparam>
   <methodparam rep="repeat"><type>array</type><parameter>arrays</parameter></methodparam>
  </methodsynopsis>
  <para>
   Vergleicht <parameter>array</parameter> mit <parameter>arrays</parameter> und
   gibt den Unterschied zurück. Im Gegensatz zu <function>array_diff</function>
   werden die Schlüssel des Arrays ebenfalls beim Vergleich herangezogen.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>

    <varlistentry>
     <term><parameter>array</parameter></term>
     <listitem>
      <para>
       Das Array, das verglichen werden soll
      </para>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term><parameter>arrays</parameter></term>
     <listitem>
      <para>
       Arrays zum Vergleichen
      </para>
     </listitem>
    </varlistentry>

   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Gibt ein <type>Array</type> zurück, das alle Werte aus
   <parameter>array</parameter> enthält, die in keinem der
   anderen Arrays vorhanden ist.
  </para>
 </refsect1>

 <refsect1 role="changelog">
  &reftitle.changelog;
  <para>
   <informaltable>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>&Version;</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      &array.changelog.require-only-one;
     </tbody>
    </tgroup>
   </informaltable>
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title><function>array_diff_assoc</function>-Beispiel</title>
    <para>
     In diesem Beispiel sieht man, dass das
     <literal>"a" =&gt; "gruen"</literal>-Paar in beiden Arrays enthalten ist
     und daher nicht in der Ausgabe der Funktion auftaucht. Andererseits ist das
     Paar <literal>0 =&gt; "rot"</literal> in der Ausgabe, weil
     <literal>"rot"</literal> im zweiten Array den Schlüssel
     <literal>1</literal> hat.
    </para>
    <programlisting role="php">
<![CDATA[
<?php
$array1 = array("a" => "gruen", "b" => "braun", "c" => "blau", "rot");
$array2 = array("a" => "gruen", "gelb", "rot");
$result = array_diff_assoc($array1, $array2);
print_r($result);
?>
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
Array
(
    [b] => braun
    [c] => blau
    [0] => rot
)
]]>
    </screen>
   </example>
  </para>
  <para>
   <example>
    <title><function>array_diff_assoc</function>-Beispiel</title>
    <para>
     Zwei Werte von <emphasis>Schlüssel =&gt; Wert</emphasis>-Paaren werden nur
     dann als gleich betrachtet, wenn <literal>(string) $elem1 === (string)
     $elem2 </literal> gilt. Anders ausgedrückt findet eine strikte Prüfung statt,
     in der die String-Repräsentationen gleich sein müssen.
    </para>
    <programlisting role="php">
<![CDATA[
<?php
$array1 = array(0, 1, 2);
$array2 = array("00", "01", "2");
$result = array_diff_assoc($array1, $array2);
print_r($result);
?>
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
Array
(
    [0] => 0
    [1] => 1
)
]]>
    </screen>
   </example>
  </para>
 </refsect1>

 <refsect1 role="notes">
  &reftitle.notes;
  <note>
   <simpara>
    Diese Funktion überprüft nur eine Dimension eines
    n-dimensionalen Arrays. Natürlich kann man tiefere Dimensionen
    überprüfen, indem man zum Beispiel
    <literal>array_diff_assoc($array1[0], $array2[0]);</literal> verwendet.
   </simpara>
  </note>
  <note>
   <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.
   </simpara>
  </note>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>array_diff</function></member>
    <member><function>array_diff_uassoc</function></member>
    <member><function>array_udiff_assoc</function></member>
    <member><function>array_udiff_uassoc</function></member>
    <member><function>array_intersect</function></member>
    <member><function>array_intersect_assoc</function></member>
   </simplelist>
  </para>
 </refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->