<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/book.array.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'fr',
  ),
  'this' => 
  array (
    0 => 'array.sorting.php',
    1 => 'Tri des tableaux',
    2 => 'Tri des tableaux',
  ),
  'up' => 
  array (
    0 => 'book.array.php',
    1 => 'Les tableaux',
  ),
  'prev' => 
  array (
    0 => 'array.constants.php',
    1 => 'Constantes pr&eacute;-d&eacute;finies',
  ),
  'next' => 
  array (
    0 => 'ref.array.php',
    1 => 'Fonctions sur les tableaux',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'fr',
    'path' => 'reference/array/sorting.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="array.sorting" class="chapter">
 <h1 class="title">Tri des tableaux</h1>

 <p class="para">
  PHP dispose de nombreuses fonctions pour trier les tableaux, 
  et cette section du manuel va aider à s&#039;y retrouver.
 </p>
 <p class="para">
  Les différences principales sont : 
 </p>
 <p class="para">
  <ul class="simplelist">
   <li>
    Certains des tris de <a href="language.types.array.php" class="link">tableau</a> sont basés sur les clés, tandis que les
    autres sont basés sur les valeurs : 
    <code class="literal">$array[&#039;cle&#039;] = &#039;valeur&#039;;</code>
   </li>
   <li>
    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 ...)
   </li>
   <li>
    L'ordre du tri peut être : alphabétique, croissant, décroissant, 
    numérique, naturel, aléatoire, ou défini par l'utilisateur.
   </li>
   <li>
    Note : toutes ces fonctions de tris travaillent sur le tableau
    lui-même, contrairement à la pratique normale qui serait de 
    retourner le tableau trié.
   </li>
   <li>
    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).
   </li>
  </ul>
 </p>
 <p class="para">
  <table class="doctable table">
   <caption><strong>Attributs de fonctions de tri</strong></caption>
   
    <thead>
     <tr>
      <th>Nom de la fonction</th>
      <th>Tri par</th>
      <th>Association clé-valeur</th>
      <th>Ordre de tri</th>
      <th>Fonctions associées</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td><span class="function"><a href="function.array-multisort.php" class="function">array_multisort()</a></span></td>
      <td>valeur</td>
      <td>clés <span class="type"><a href="language.types.string.php" class="type string">string</a></span> oui, clés <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> non</td>
      <td>premier tableau, ou bien options de tri</td>
      <td><span class="function"><a href="function.array-walk.php" class="function">array_walk()</a></span></td>
     </tr>

     <tr>
      <td><span class="function"><a href="function.asort.php" class="function">asort()</a></span></td>
      <td>valeur</td>
      <td>oui</td>
      <td>croissant</td>
      <td><span class="function"><a href="function.arsort.php" class="function">arsort()</a></span></td>
     </tr>

     <tr>
      <td><span class="function"><a href="function.arsort.php" class="function">arsort()</a></span></td>
      <td>valeur</td>
      <td>oui</td>
      <td>décroissant</td>
      <td><span class="function"><a href="function.asort.php" class="function">asort()</a></span></td>
     </tr>

     <tr>
      <td><span class="function"><a href="function.krsort.php" class="function">krsort()</a></span></td>
      <td>clé</td>
      <td>oui</td>
      <td>décroissant</td>
      <td><span class="function"><a href="function.ksort.php" class="function">ksort()</a></span></td>
     </tr>

     <tr>
      <td><span class="function"><a href="function.ksort.php" class="function">ksort()</a></span></td>
      <td>clé</td>
      <td>oui</td>
      <td>croissant</td>
      <td><span class="function"><a href="function.krsort.php" class="function">krsort()</a></span></td>
     </tr>

     <tr>
      <td><span class="function"><a href="function.natcasesort.php" class="function">natcasesort()</a></span></td>
      <td>valeur</td>
      <td>oui</td>
      <td>naturel, insensible à la casse</td>
      <td><span class="function"><a href="function.natsort.php" class="function">natsort()</a></span></td>
     </tr>

     <tr>
      <td><span class="function"><a href="function.natsort.php" class="function">natsort()</a></span></td>
      <td>valeur</td>
      <td>oui</td>
      <td>naturel</td>
      <td><span class="function"><a href="function.natcasesort.php" class="function">natcasesort()</a></span></td>
     </tr>

     <tr>
      <td><span class="function"><a href="function.rsort.php" class="function">rsort()</a></span></td>
      <td>valeur</td>
      <td>non</td>
      <td>décroissant</td>
      <td><span class="function"><a href="function.sort.php" class="function">sort()</a></span></td>
     </tr>

     <tr>
      <td><span class="function"><a href="function.shuffle.php" class="function">shuffle()</a></span></td>
      <td>valeur</td>
      <td>non</td>
      <td>aléatoire</td>
      <td><span class="function"><a href="function.array-rand.php" class="function">array_rand()</a></span></td>
     </tr>

     <tr>
      <td><span class="function"><a href="function.sort.php" class="function">sort()</a></span></td>
      <td>valeur</td>
      <td>non</td>
      <td>croissant</td>
      <td><span class="function"><a href="function.rsort.php" class="function">rsort()</a></span></td>
     </tr>

     <tr>
      <td><span class="function"><a href="function.uasort.php" class="function">uasort()</a></span></td>
      <td>valeur</td>
      <td>oui</td>
      <td>Défini par une fonction utilisateur</td>
      <td><span class="function"><a href="function.uksort.php" class="function">uksort()</a></span></td>
     </tr>

     <tr>
      <td><span class="function"><a href="function.uksort.php" class="function">uksort()</a></span></td>
      <td>clé</td>
      <td>oui</td>
      <td>Défini par une fonction utilisateur</td>
      <td><span class="function"><a href="function.uasort.php" class="function">uasort()</a></span></td>
     </tr>

     <tr>
      <td><span class="function"><a href="function.usort.php" class="function">usort()</a></span></td>
      <td>valeur</td>
      <td>non</td>
      <td>Défini par une fonction utilisateur</td>
      <td><span class="function"><a href="function.uasort.php" class="function">uasort()</a></span></td>
     </tr>

    </tbody>
   
  </table>

 </p>
</div>
<?php manual_footer($setup); ?>