Man Versionsort en français
SCANDIR(3)                Manuel du programmeur Linux               SCANDIR(3)



 

NOM


       scandir, alphasort, versionsort - Selectionner des elements d'un reper-
       toire.

 

SYNOPSIS


       #include 

       int scandir (const char * dir, struct dirent ***namelist,
              int (*select)(const struct diren t *),
              int (*compar)(const struct dirent **, const struct dirent **));

       int alphasort (const void *a, const void * b);
       int versionsort (const void *a, const void * b);

 

DESCRIPTION






       La fonction scandir() examine le repertoire dir, en  appelant  select()
       pour  chaque  element  rencontre.  Les entrees pour lesquelles select()
       renvoie une valeur non-nulle sont stockees dans une table allouee  avec
       malloc(),  triee  avec  qsort() en utilisant la fonction de comparaison
       compar(), puis regroupees dans une table  namelist  allouee  avec  mal-
       loc().  Si select est NULL, toutes les entrees sont selectionnees.

       Les fonctions alphasort() et versionsort() peuvent etre utilisees comme
       fonction de comparaison dans la fonction scandir().  La  premiere  trie
       les  entrees  du  repertoire  en  ordre  alphabetique en utilisant str-
       coll(3),  la  seconde  en  utilisant  strverscmp(3)  sur  les   chaines
       (*a)->d_name et (*b)->d_name.

 

VALEUR RENVOYEE


       La  fonction scandir() renvoie le nombre d'entrees de repertoire selec-
       tionnees ou -1 en cas d'erreur.

       Les fonctions alphasort() et versionsort() renvoient un entier negatif,
       nul,  ou  positif  si le premier argument est respectivement inferieur,
       egal ou superieur au second.

 

ERREURS


       ENOMEM Pas assez de memoire.

 

CONFORMITE


       Aucune de ces fonctions n'est decrite  par  POSIX.1-2001,  mais  alpha-
       sort()  et  scandir()  pourraient faire partie d'une future revision de
       POSIX.1.

       Les fonctions scandir() et alphasort() proviennent de BSD 4.3  et  sont
       disponibles  sous Linux depuis libc4.  Les bibliotheques libc4 et libc5
       utilisent le prototype plus precis

           "int alphasort(const struct dirent **" a,
                          const struct dirent **" b);

       mais la glibc 2.0 est revenue au prototype BSD imprecis.

       La fonction versionsort() est une extension GNU, disponible  depuis  la
       glibc 2.1.

       Depuis la glibc 2.1, la fonction alphasort() invoque strcoll(3) ; alors
       qu'auparavant elle employait strcmp(3).

 

EXEMPLE


       /* Afficher le contenu du repertoire en ordre inverse */
       #include 
       main(){
           struct dirent **namelist;
           int n;

           n = scandir(".", &namelist, 0, alphasort);
           if (n < 0)
               perror("scandir");
           else {
               while(n--) {
                   printf("%s\n", namelist[n]->d_name);
                   free (namelist [n]);
               }
               free (namelist);
           }
       }

 

VOIR AUSSI


       opendir(3), readdir(3),  closedir(3),  rewinddir(3),  seekdir(3),  str-
       cmp(3), strcoll(3), strverscmp(3), telldir(3)

 

TRADUCTION


       Ce   document   est  une  traduction  realisee  par  Christophe  Blaess
        le  7 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 scandir .
       N'hesitez pas a signaler a l'auteur ou au  traducteur,  selon  le  cas,
       toute erreur dans cette page de manuel.



LDP                            26 decembre 2001                     SCANDIR(3)