array.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 43d07782b514d0c7a8487f2c74063739f302df8d Maintainer: nobody Status: ready -->
<!-- Reviewed: yes -->
<!-- Rev-Revision: e4b889a3e8b9d87ab605aac9bbe85d2c16c69a1b Reviewer: samesch -->
<!-- CREDITS: tzwenny, betz -->
<sect1 xml:id="language.operators.array">
 <title>Array-Operatoren</title>
 <titleabbrev>Array</titleabbrev>
 <table>
  <title>Array-Operatoren</title>
  <tgroup cols="3">
   <thead>
    <row>
     <entry>Beispiel</entry>
     <entry>Name</entry>
     <entry>Ergebnis</entry>
    </row>
   </thead>
   <tbody>
    <row>
     <entry>$a + $b</entry>
     <entry>Vereinigung</entry>
     <entry>Vereinigung von <varname>$a</varname> und <varname>$b</varname>.</entry>
    </row>
    <row>
     <entry>$a == $b</entry>
     <entry>Gleichwertigkeit</entry>
     <entry>
      &true; wenn <varname>$a</varname> und <varname>$b</varname> dieselben
      Schlüssel-/Wert-Paare enthalten.
     </entry>
    </row>
    <row>
     <entry>$a === $b</entry>
     <entry>Identität</entry>
     <entry>
      &true; wenn <varname>$a</varname> und <varname>$b</varname> dieselben
      Schlüssel-/Wert-Paare in der gleichen Reihenfolge und vom selben Typ
      enthalten.
     </entry>
    </row>
    <row>
     <entry>$a != $b</entry>
     <entry>Ungleichheit</entry>
     <entry>&true; wenn <varname>$a</varname> nicht gleich<varname>$b</varname> ist.</entry>
    </row>
    <row>
     <entry>$a &lt;&gt; $b</entry>
     <entry>Ungleichheit</entry>
     <entry>&true; wenn <varname>$a</varname> nicht gleich<varname>$b</varname> ist.</entry>
    </row>
    <row>
     <entry>$a !== $b</entry>
     <entry>nicht identisch</entry>
     <entry>&true; wenn <varname>$a</varname> nicht identisch zu <varname>$b</varname> ist.</entry>
    </row>
   </tbody>
  </tgroup>
 </table>
 <para>
  Der Operator <literal>+</literal> hängt das rechsstehende Array an das
  linksstehende Array an; kommen Schlüssel in beiden Arrays vor, dann werden
  die Elemente des linksstehenden Arrays verwendet, und die entsprechenden
  Elemente des rechtstehenden Arrays werden ignoriert.
 </para>
 <para>
  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php
$a = array("a" => "Apfel", "b" => "Banane");
$b = array("a" =>"Birne", "b" => "Erdbeere", "c" => "Kirsche");

$c = $a + $b; // Vereinigung von $a mit $b;
echo "Vereinigung von \$a mit \$b: \n";
var_dump($c);

$c = $b + $a; // Vereinigung von $b mit $a;
echo "Vereinigung von \$b mit \$a: \n";
var_dump($c);

$a += $b; // Vereinigung von $a += $b ist $a + $b
echo "Vereinigung von \$a += \$b: \n";
var_dump($a);
?>
]]>
   </programlisting>
  </informalexample>
  Dieses Skript gibt folgendes aus:
  <screen role="php">
<![CDATA[
Vereinigung von $a mit $b:
array(3) {
  ["a"]=>
  string(5) "Apfel"
  ["b"]=>
  string(6) "Banane"
  ["c"]=>
  string(7) "Kirsche"
}
Vereinigung von $b mit $a:
array(3) {
  ["a"]=>
  string(4) "Birne"
  ["b"]=>
  string(8) "Erdbeere"
  ["c"]=>
  string(7) "Kirsche"
}
Vereinigung von $a += $b:
array(3) {
  ["a"]=>
  string(5) "Apfel"
  ["b"]=>
  string(6) "Banane"
  ["c"]=>
  string(6) "Kirsche"
}
]]>
  </screen>
 </para>
 <para>
  Beim Vergleich werden Arrayelemente als gleich angesehen, wenn diese
  dieselben Schlüssel und Werte beinhalten.
 </para>
 <para>
  <example>
   <title>Array-Vergleiche</title>
   <programlisting role="php">
<![CDATA[
<?php
$a = array("Apfel", "Banane");
$b = array(1 => "Banane", "0" => "Apfel");

var_dump($a == $b); // bool(true)
var_dump($a === $b); // bool(false)
?>
]]>
   </programlisting>
  </example>
 </para>

 <sect2 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><link linkend="language.types.array">Arrays</link></member>
    <member><link linkend="ref.array">Array-Funktionen</link></member>
   </simplelist>
  </para>
 </sect2>
</sect1>