SCANDIR(3C)             COMMAND REFERENCE             SCANDIR(3C)



NAME
     scandir - scan a directory

SYNOPSIS
     #include <sys/types.h>
     #include <sys/dir.h>

     scandir(dirname, namelist, select, compar)
     char *dirname;
     struct direct *(*namelist[]);
     int (*select)();
     int (*compar)();

     alphasort(d1, d2)
     struct direct **d1, **d2;

DESCRIPTION
     Scandir reads the directory dirname and builds an array of
     pointers to directory entries using malloc(3c). The third
     parameter is a pointer to a routine which is called with a
     pointer to a directory entry and should return a nonzero
     value if the directory entry should be included in the
     array.  If this pointer is null, then all the directory
     entries will be included.  The last argument is a pointer to
     a routine which is passed to qsort(3c) to sort the completed
     array. If this pointer is null, the array is not sorted.
     Alphasort is a routine which will sort the array
     alphabetically.

     Scandir returns the number of entries in the array and a
     pointer to the array through the parameter namelist.

DIAGNOSTICS
     Returns -1 if the directory cannot be opened for reading or
     if malloc(3c) cannot allocate enough memory to hold all the
     data structures.

SEE ALSO
     directory(3c), malloc(3c), and qsort(3c).
















Printed 3/13/89                                                 1

%%index%%
na:336,78;
sy:414,2217;
de:2631,1161;
di:3792,291;
se:4083,191;
%%index%%000000000097