sorting.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 79a458220566758cd6abb064de988bebe9246028 Maintainer: takagi Status: ready -->

<chapter xml:id="array.sorting" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>配列のソート</title>
 <para>
  PHP には配列をソートする関数が複数用意されています。
  このページでは、それらの違いについて説明します。
 </para>
 <para>
  主な相違点は次のとおりです。
 </para>
 <para>
  <simplelist>
   <member>
    配列のキーでソートするものと、値でソートするものがあります。
    <literal>$array['キー'] = '値';</literal>
   </member>
   <member>
    キーと値の相関関係をソート後にも保持するものと保持しないものがあります。
    保持しないものは、ソート後にキーを (0,1,2 ... と) 振りなおします。
   </member>
   <member>
    ソート順による違いがあります。アルファベット順、
    昇順、降順、数値順、自然順、ランダム、ユーザー定義の順などです。
   </member>
   <member>
    注意: ソート関数は、すべて配列自身を直接変更します。
    ソートした配列を新しく作って返すわけではありません。
   </member>
   <member>
    これらのソート関数でふたつのメンバーが等しいと判断されたときの並び順は未定義です
    (ソート結果は場合によって変わる可能性があります)。
   </member>
  </simplelist>
 </para>
 <para>
  <table>
   <title>ソート関数の特性</title>
   <tgroup cols="5">
    <thead>
     <row>
      <entry>関数名</entry>
      <entry>ソートの基準</entry>
      <entry>キーと値の相関関係</entry>
      <entry>ソート順</entry>
      <entry>関連する関数</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry><function>array_multisort</function></entry>
      <entry>値</entry>
      <entry>連想配列の場合は維持し、数値添字配列の場合は維持しない</entry>
      <entry>最初の配列、あるいはソートオプション</entry>
      <entry><function>array_walk</function></entry>
     </row>
     <row>
      <entry><function>asort</function></entry>
      <entry>値</entry>
      <entry>維持する</entry>
      <entry>昇順</entry>
      <entry><function>arsort</function></entry>
     </row>
     <row>
      <entry><function>arsort</function></entry>
      <entry>値</entry>
      <entry>維持する</entry>
      <entry>降順</entry>
      <entry><function>asort</function></entry>
     </row>
     <row>
      <entry><function>krsort</function></entry>
      <entry>キー</entry>
      <entry>維持する</entry>
      <entry>降順</entry>
      <entry><function>ksort</function></entry>
     </row>
     <row>
      <entry><function>ksort</function></entry>
      <entry>キー</entry>
      <entry>維持する</entry>
      <entry>昇順</entry>
      <entry><function>asort</function></entry>
     </row>
     <row>
      <entry><function>natcasesort</function></entry>
      <entry>値</entry>
      <entry>維持する</entry>
      <entry>大文字小文字を区別しない自然順</entry>
      <entry><function>natsort</function></entry>
     </row>
     <row>
      <entry><function>natsort</function></entry>
      <entry>値</entry>
      <entry>維持する</entry>
      <entry>自然順</entry>
      <entry><function>natcasesort</function></entry>
     </row>
     <row>
      <entry><function>rsort</function></entry>
      <entry>値</entry>
      <entry>維持しない</entry>
      <entry>降順</entry>
      <entry><function>sort</function></entry>
     </row>
     <row>
      <entry><function>shuffle</function></entry>
      <entry>値</entry>
      <entry>維持しない</entry>
      <entry>ランダム</entry>
      <entry><function>array_rand</function></entry>
     </row>
     <row>
      <entry><function>sort</function></entry>
      <entry>値</entry>
      <entry>維持しない</entry>
      <entry>昇順</entry>
      <entry><function>rsort</function></entry>
     </row>
     <row>
      <entry><function>uasort</function></entry>
      <entry>値</entry>
      <entry>維持する</entry>
      <entry>ユーザー定義</entry>
      <entry><function>uksort</function></entry>
     </row>
     <row>
      <entry><function>uksort</function></entry>
      <entry>キー</entry>
      <entry>維持する</entry>
      <entry>ユーザー定義</entry>
      <entry><function>uasort</function></entry>
     </row>
     <row>
      <entry><function>usort</function></entry>
      <entry>値</entry>
      <entry>維持しない</entry>
      <entry>ユーザー定義</entry>
      <entry><function>uasort</function></entry>
     </row>
    </tbody>
   </tgroup>
  </table>
 </para>
</chapter>

<!-- 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
-->