sorting.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d1df62fe77b6cb0676d064e8e63ee2c3304d4260 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<chapter xml:id="array.sorting" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>Tri des tableaux</title>
 <para>
  PHP dispose de nombreuses fonctions pour trier les tableaux, 
  et cette section du manuel va vous aider à vous y retrouver.
 </para>
 <para>
  Les différences principales sont : 
 </para>
 <para>
  <simplelist>
   <member>
    Certains des tris de &array; sont basés sur les clés, tandis que les
    autres sont basés sur les valeurs : 
    <literal>$array['cle'] = 'valeur';</literal>
   </member>
   <member>
    Certains tris maintiennent la corrélation entre les clés 
    et les valeurs, et d'autres non, ce qui signifie que les clés
    sont généralement réaffectées numériquement (0,1,2 ...)
   </member>
   <member>
    L'ordre du tri peut être : alphabétique, croissant, décroissant, 
    numérique, naturel, aléatoire, ou définit par l'utilisateur.
   </member>
   <member>
    Note : toutes ces fonctions de tris travaillent sur le tableau
    lui-même, contrairement à la pratique normale qui serait de 
    retourner le tableau trié.
   </member>
   <member>
    Si une de ces fonctions de tri évalue 2 membres comme égaux,
    alors ils retiennent l'ordre original.
    Antérieur à PHP 8.0.0, leur ordre était indéfini (le tri n'était pas stable).
   </member>
  </simplelist>
 </para>
 <para>
  <table>
   <title>Attributs de fonctions de tri</title>
   <tgroup cols="5">
    <thead>
     <row>
      <entry>Nom de la fonction</entry>
      <entry>Tri par</entry>
      <entry>Association clé-valeur</entry>
      <entry>Ordre de tri</entry>
      <entry>Fonctions associée</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry><function>array_multisort</function></entry>
      <entry>valeur</entry>
      <entry>clés <type>string</type> oui, clés <type>int</type> non</entry>
      <entry>premier tableau, ou bien options de tri</entry>
      <entry><function>array_walk</function></entry>
     </row>
     <row>
      <entry><function>asort</function></entry>
      <entry>valeur</entry>
      <entry>oui</entry>
      <entry>croissant</entry>
      <entry><function>arsort</function></entry>
     </row>
     <row>
      <entry><function>arsort</function></entry>
      <entry>valeur</entry>
      <entry>oui</entry>
      <entry>décroissant</entry>
      <entry><function>asort</function></entry>
     </row>
     <row>
      <entry><function>krsort</function></entry>
      <entry>clé</entry>
      <entry>oui</entry>
      <entry>décroissant</entry>
      <entry><function>ksort</function></entry>
     </row>
     <row>
      <entry><function>ksort</function></entry>
      <entry>clé</entry>
      <entry>oui</entry>
      <entry>croissant</entry>
      <entry><function>asort</function></entry>
     </row>
     <row>
      <entry><function>natcasesort</function></entry>
      <entry>valeur</entry>
      <entry>oui</entry>
      <entry>naturel, insensible à la casse</entry>
      <entry><function>natsort</function></entry>
     </row>
     <row>
      <entry><function>natsort</function></entry>
      <entry>valeur</entry>
      <entry>oui</entry>
      <entry>naturel</entry>
      <entry><function>natcasesort</function></entry>
     </row>
     <row>
      <entry><function>rsort</function></entry>
      <entry>valeur</entry>
      <entry>non</entry>
      <entry>décroissant</entry>
      <entry><function>sort</function></entry>
     </row>
     <row>
      <entry><function>shuffle</function></entry>
      <entry>valeur</entry>
      <entry>non</entry>
      <entry>aléatoire</entry>
      <entry><function>array_rand</function></entry>
     </row>
     <row>
      <entry><function>sort</function></entry>
      <entry>valeur</entry>
      <entry>non</entry>
      <entry>croissant</entry>
      <entry><function>rsort</function></entry>
     </row>
     <row>
      <entry><function>uasort</function></entry>
      <entry>valeur</entry>
      <entry>oui</entry>
      <entry>Défini par une fonction utilisateur</entry>
      <entry><function>uksort</function></entry>
     </row>
     <row>
      <entry><function>uksort</function></entry>
      <entry>clé</entry>
      <entry>oui</entry>
      <entry>Défini par une fonction utilisateur</entry>
      <entry><function>uasort</function></entry>
     </row>
     <row>
      <entry><function>usort</function></entry>
      <entry>valeur</entry>
      <entry>non</entry>
      <entry>Défini par une fonction utilisateur</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
-->