array.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 16934048f79c6e117cd16a23c09c1b2ea502e284 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<sect1 xml:id="language.operators.array">
 <title>Opérateurs de tableaux</title>
 <table>
  <title>Opérateurs de tableaux</title>
  <titleabbrev>Tableaux</titleabbrev>
  <tgroup cols="3">
   <thead>
    <row>
     <entry>Exemple</entry>
     <entry>Nom</entry>
     <entry>Résultat</entry>
    </row>
   </thead>
   <tbody>
    <row>
     <entry>$a + $b</entry>
     <entry>Union</entry>
     <entry>Union de <varname>$a</varname> et <varname>$b</varname>.</entry>
    </row>
    <row>
     <entry>$a == $b</entry>
     <entry>Égalité</entry>
     <entry>&true; si <varname>$a</varname> et <varname>$b</varname> contiennent les mêmes paires clés/valeurs.</entry>
    </row>
    <row>
     <entry>$a === $b</entry>
     <entry>Identique</entry>
     <entry>&true; si <varname>$a</varname> et <varname>$b</varname> contiennent les mêmes paires clés/valeurs dans le même ordre et du même type.</entry>
    </row>
    <row>
     <entry>$a != $b</entry>
     <entry>Inégalité</entry>
     <entry>&true; si <varname>$a</varname> n'est pas égal à <varname>$b</varname>.</entry>
    </row>
    <row>
     <entry>$a &lt;&gt; $b</entry>
     <entry>Inégalité</entry>
     <entry>&true; si <varname>$a</varname> n'est pas égal à <varname>$b</varname>.</entry>
    </row>
    <row>
     <entry>$a !== $b</entry>
     <entry>Non-identique</entry>
     <entry>&true; si <varname>$a</varname> n'est pas identique à <varname>$b</varname>.</entry>
    </row>
   </tbody>
  </tgroup>
 </table>
 <para>
  L'opérateur <literal>+</literal> retourne le tableau de gauche auquel sont
  ajoutés les éléments du tableau de droite. Pour les clés présentes dans les
  2 tableaux, les éléments du tableau de gauche seront utilisés alors que les
  éléments correspondants dans le tableau de droite seront ignorés.
 </para>
 <para>
  <example>
   <title>L'opérateur d'ajout à un tableau</title>
   <programlisting role="php">
<![CDATA[
<?php
$a = array("a" => "pomme", "b" => "banane");
$b = array("a" =>"poire", "b" => "fraise", "c" => "cerise");

$c = $a + $b; // Union de $a et $b
echo "Union de \$a et \$b : \n";
var_dump($c);

$c = $b + $a; // Union de $b et $a
echo "Union de \$b et \$a : \n";
var_dump($c);

$a += $b; // Union de $a += $b est $a and $b
echo "Union de \$a += \$b: \n";
var_dump($a);
?>
]]>
   </programlisting>
   &example.outputs;
   <screen role="php">
<![CDATA[
Union de $a et $b :
array(3) {
  ["a"]=>
  string(5) "pomme"
  ["b"]=>
  string(6) "banane"
  ["c"]=>
  string(6) "cerise"
}
Union de $b et $a :
array(3) {
  ["a"]=>
  string(5) "poire"
  ["b"]=>
  string(6) "fraise"
  ["c"]=>
  string(6) "cerise"
}
Union de $a += $b:
array(3) {
  ["a"]=>
  string(5) "pomme"
  ["b"]=>
  string(6) "banane"
  ["c"]=>
  string(6) "cerise"
}
]]>
   </screen>
  </example>
 </para>
 <para>
  Les éléments d'un tableau sont égaux en termes de comparaison s'ils ont la
  même clé et la même valeur.
 </para>
 <para>
  <example>
   <title>Comparer des tableaux</title>
   <programlisting role="php">
<![CDATA[
<?php
$a = array("pomme", "banane");
$b = array(1 => "banane", "0" => "pomme");

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">Le type array</link></member>
    <member><link linkend="ref.array">Les Fonctions de Tableaux</link></member>
   </simplelist>
  </para>
 </sect2>
</sect1>