array.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 43d07782b514d0c7a8487f2c74063739f302df8d Maintainer: mumumu Status: ready -->
<sect1 xml:id="language.operators.array">
 <title>配列演算子</title>
 <titleabbrev>配列演算子</titleabbrev>
 <table>
  <title>Array Operators</title>
  <tgroup cols="3">
   <thead>
    <row>
     <entry>例</entry>
     <entry>名前</entry>
     <entry>結果</entry>
    </row>
   </thead>
   <tbody>
    <row>
     <entry>$a + $b</entry>
     <entry>結合</entry>
     <entry><varname>$a</varname> および <varname>$b</varname> を結合する。</entry>
    </row>
    <row>
     <entry>$a == $b</entry>
     <entry>同等</entry>
     <entry><varname>$a</varname> および <varname>$b</varname> のキー/値のペアが等しい場合に &true;。</entry>
    </row>
    <row>
     <entry>$a === $b</entry>
     <entry>同一</entry>
     <entry>
      <varname>$a</varname> および <varname>$b</varname> のキー/値のペアが等しく、その並び順が等しく、
      かつデータ型も等しい場合に &true;。
     </entry>
    </row>
    <row>
     <entry>$a != $b</entry>
     <entry>等しくない</entry>
     <entry><varname>$a</varname> が <varname>$b</varname> と等しくない場合に &true;。</entry>
    </row>
    <row>
     <entry>$a &lt;&gt; $b</entry>
     <entry>等しくない</entry>
     <entry><varname>$a</varname> が <varname>$b</varname> と等しくない場合に &true;。</entry>
    </row>
    <row>
     <entry>$a !== $b</entry>
     <entry>同一でない</entry>
     <entry><varname>$a</varname> が <varname>$b</varname> と同一でない場合に &true;。</entry>
    </row>
   </tbody>
  </tgroup>
 </table>
 <para>
  <literal>+</literal> 演算子は、右側の配列を左側の配列に追加したものを返します。
  両方の配列に存在するキーについては左側の配列の要素が優先され、
  右側の配列にあった同じキーの要素は無視されます。
 </para>
 <para>
  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php
$a = array("a" => "apple", "b" => "banana");
$b = array("a" => "pear", "b" => "strawberry", "c" => "cherry");

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

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

$a += $b; // Union of $a += $b is $a and $b
echo "Union of \$a += \$b: \n";
var_dump($a);
?>
]]>
   </programlisting>
  </informalexample>
  このスクリプトを実行すると、以下のように出力されます。
  <screen role="php">
<![CDATA[
Union of $a and $b:
array(3) {
["a"]=>
string(5) "apple"
["b"]=>
string(6) "banana"
["c"]=>
string(6) "cherry"
}
Union of $b and $a:
array(3) {
["a"]=>
string(4) "pear"
["b"]=>
string(10) "strawberry"
["c"]=>
string(6) "cherry"
}
Union of $a += $b:
array(3) {
["a"]=>
string(5) "apple"
["b"]=>
string(6) "banana"
["c"]=>
string(6) "cherry"
}
]]>
  </screen>
 </para>
 <para>
  同じキーと値を保持している場合に、配列が等しいとみなされます。
 </para>
 <para>
  <example>
   <title>配列の比較</title>
   <programlisting role="php">
<![CDATA[
<?php
$a = array("apple", "banana");
$b = array(1 => "banana", "0" => "apple");

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">配列</link></member>
    <member><link linkend="ref.array">配列関数</link></member>
   </simplelist>
  </para>
 </sect2>

</sect1>