up | Inhaltsverzeichniss | Kommentar

Manual page for SCANDIR(3)

scandir, alphasort - 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.3v The second parameter is a pointer to an array of structure pointers. The third parameter is a pointer to a routine which is called with a pointer to a directory entry and should return a non zero 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.3 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.

SEE ALSO

directory.3v malloc.3v qsort.3

DIAGNOSTICS

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


index | Inhaltsverzeichniss | Kommentar

Created by unroff & hp-tools. © somebody (See intro for details). All Rights Reserved. Last modified 11/5/97