scandir
Hurricane Electric Internet Services
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(3), readdir(3), closedir(3), rewinddir(3),
telldir(3), seekdir(3)
Hurricane Electric Internet Services
Copyright (C) 1998
Hurricane Electric.
All Rights Reserved.