SCANDIR(3)          Linux Programmer's Manual          SCANDIR(3)


NAME
       scandir, alphasort - scan a directory for matching entries

SYNOPSIS
       #include <dirent.h>

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

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

DESCRIPTION
       The scandir() function scans the  directory  dir,  calling
       select()  on  each  directory  entry.   Entries  for which
       select() returns non-zero are stored in strings  allocated
       via  malloc(),  sorted  using  qsort() with the comparison
       function compar(), and collected in array  namelist  which
       is allocated via malloc().

       The  alphasort()  function  can  be used as the comparison
       function for the scandir() function to sort the  directory
       entries  into  alphabetical order.  Its parameters are the
       two directory entries, a and b, to compare.

RETURN VALUE
       The scandir() function returns  the  number  of  directory
       entries selected or -1 if an error occurs.

       The  alphasort()  function  returns  an integer less than,
       equal to, or greater than zero if the  first  argument  is
       considered  to  be  respectively  less  than, equal to, or
       greater than the second.

ERRORS
       ENOMEM Insufficient memory to complete the operation.

CONFORMING TO
       BSD 4.3

SEE ALSO

opendir, readdir, closedir, rewinddir, telldir, seekdir,

GNU                       March 31, 1993                        1