doc-fr/reference/array/functions/usort.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- splitted from ./fr/functions/array.xml, last change in rev 1.30 -->
<!-- last change to 'usort' in en/ tree in rev 1.2 -->
 <refentry id="function.usort">
  <refnamediv>
   <refname>usort</refname>
   <refpurpose>
    Trie un tableau en utilisant une fonction de comparaison d&eacute;finie
    par l'utilisateur
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>void</type><methodname>usort</methodname>
     <methodparam><type>array</type><parameter>array</parameter></methodparam>
     <methodparam><type>function</type><parameter>cmp_function</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>usort</function> va trier un tableau avec ses valeurs, en utilisant une fonction
    d&eacute;finie par l'utilisateur. Si un tableau doit &ecirc;tre tri&eacute;
    avec un crit&egrave;re complexe, il est pr&eacute;f&eacute;rable d'utiliser
    cette m&eacute;thode.
   </para>
   <para>
    La fonction de comparaison <parameter>cmp_function</parameter> doit retourner un entier,
    qui sera inf&eacute;rieur, &eacute;gal ou sup&eacute;rieur &agrave; z&eacute;ro
    suivant que le premier argument est consid&eacute;r&eacute; comme plus petit,
    &eacute;gal ou plus grand que le second argument. Si les deux arguments sont
    &eacute;gaux, leur ordre est ind&eacute;fini.
    <example>
     <title>Exemple avec <function>usort</function></title>
     <programlisting role="php">
&lt;?php
  function cmp($a,$b) {
    if ($a == $b) return 0;
    return ($a &lt; $b) ? -1 : 1;
  }
  $tableau = array(3,2,5,6,1);
  usort($a, "cmp");
  while(list($cle,$valeur) = each($tableau)) {
    echo "$cle: $valeur\n";
  }
?&gt;
     </programlisting>
    </example>
    Cet exemple va afficher :
    <computeroutput>
    0: 6
    1: 5
    2: 3
    3: 2
    4: 1
    </computeroutput>
    <note>
     <para>
      Evidemment dans ce cas trivial, <function>rsort</function> serait plus
      appropri&eacute;.
     </para>
    </note>
    <warning>
    <para>
     Les biblioth&egrave;ques de tri rapides sur lesquelles reposent PHP
     peuvent le conduire &agrave; un plantage, si la fonction de comparaison
     ne retourne pas une valeur coh&eacute;rente.
    </para>
    </warning>
   </para>
   <para>
    Voir aussi
    <function>array-multisort</function>,
    <function>arsort</function>,
    <function>asort</function>,
    <function>krsort</function>,
    <function>ksort</function>,
    <function>natsort</function>,
    <function>natcasesort</function>,
    <function>rsort</function>,
    <function>sort</function>,
    <function>uasort</function> et
    <function>uksort</function>.
   </para>
  </refsect1>
 </refentry>

<!-- 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:"../../../../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
-->