Man Qsort en français
QSORT(3)                  Manuel du programmeur Linux                 QSORT(3)



 

NOM


       qsort - Trier une table.

 

SYNOPSIS


       #include 

       void qsort (void *base, size_t nmemb, size_t size,
              int (*compar)(const void *, const void *));

 

DESCRIPTION






       La  fonction  qsort() trie une table contenant nmemb elements de taille
       size. L'argument base pointe sur le debut de la table.

       Le contenu de la table est trie en ordre  croissant,  en  utilisant  la
       fonction  de  comparaison pointee par compar, laquelle est appelee avec
       deux arguments pointant sur les objets a comparer.

       La fonction de comparaison doit renvoyer un entier inferieur, egal,  ou
       superieur  a  zero  si le premier argument est respectivement considere
       comme inferieur, egal ou superieur au second.  Si  la  comparaison  des
       deux  arguments  renvoie  une egalite (valeur de retour nulle), l'ordre
       des deux elements est indefini.

 

VALEUR RENVOYEE


       La fonction qsort() ne renvoie pas de valeur.

 

CONFORMITE


       SVr4, BSD 4.3, C99.

 

NOTE


       Parmi les routines de la bibliotheque utilisables comme  argument  com-
       par, on a strcmp() (voir plus loin), alphasort() et versionsort().

 

EXEMPLES


       Pour un exemple d'utilisation, voir l'exemple de la page bsearch(3).

       Un  autre  exemple  est  le suivant qui trie les chaines fournies comme
       argument sur la ligne de commande :

       #include 
       #include 
       #include 
       #include 
       #include 

       static int
       cmpstringp(const void *p1, const void *p2)
       {
           /* The actual arguments to this function are "pointers to
              pointers to char", but strcmp() arguments are "pointers
              to char", hence the following cast plus dereference */

           return strcmp(* (char * const *) p1, * (char * const *) p2);
       }

       int
       main(int argc, char *argv[])
       {
           int j;

           assert(argc > 1);

           qsort(&argv[1], argc - 1, sizeof(char *), cmpstringp);

           for (j = 1; j < argc; j++)
               puts(argv[j]);
           exit(EXIT_SUCCESS);
       }

 

VOIR AUSSI


       sort(1), alphasort(3), strcmp(3), versionsort(3)

 

TRADUCTION


       Ce  document  est  une  traduction  realisee  par   Christophe   Blaess
         le  5 novembre 1996  et  revisee le
       14 aot 2006.

       L'equipe de traduction a fait le maximum pour realiser  une  adaptation
       francaise de qualite. La version anglaise la plus a jour de ce document
       est  toujours  consultable  via  la  commande :    LANG=C man 3 qsort .
       N'hesitez  pas  a  signaler  a l'auteur ou au traducteur, selon le cas,
       toute erreur dans cette page de manuel.



LDP                            15 novembre 2003                       QSORT(3)