1scandir(3UCB)      SunOS/BSD Compatibility Library Functions     scandir(3UCB)
2
3
4

NAME

6       scandir, alphasort - scan a directory
7

SYNOPSIS

9       /usr/ucb/cc [ flag... ] file...
10       #include <sys/types.h>
11       #include <sys/dir.h>
12
13       int scandir(dirname, namelist, select, dcomp)
14       char *dirname;
15       struct direct *(*namelist[]);
16       int (*select(), (*dcomp)();
17
18
19       int alphasort(d1, d2)
20       struct direct **d1, **d2;
21
22

DESCRIPTION

24       The  scandir() function reads the directory dirname and builds an array
25       of pointers to directory entries using malloc(3C). The second parameter
26       is  a pointer to an array of structure pointers. The third parameter is
27       a pointer to a routine which is called with a pointer  to  a  directory
28       entry  and should return a non zero value if the directory entry should
29       be included in the array. If this pointer is NULL, then all the  direc‐
30       tory entries will be included. The last argument is a pointer to a rou‐
31       tine which is passed to qsort(3C), which sorts the completed array.  If
32       this pointer is NULL, the array is not sorted.
33
34
35       The alphasort() function sorts the array alphabetically.
36

RETURN VALUES

38       The scandir() function returns the number of entries in the array and a
39       pointer to the array through  the  parameter  namelist.  The  scandir()
40       function returns −1 if the directory cannot be opened for reading or if
41       malloc(3C) cannot allocate enough memory to hold all  the  data  struc‐
42       tures.
43
44
45       The  alphasort() function returns an integer greater than, equal to, or
46       less than 0 if the directory entry name pointed to  by  d1  is  greater
47       than, equal to, or less than the directory entry name pointed to by d2.
48

USAGE

50       The  scandir()  and  alphasort() functions have transitional interfaces
51       for 64-bit file offsets. See lf64(5).
52

SEE ALSO

54       getdents(2), malloc(3C), qsort(3C), readdir(3UCB), readdir(3C), lf64(5)
55

NOTES

57       Use of these functions should be restricted to applications written  on
58       BSD platforms.  Use of these functions with any of the system libraries
59       or in multithreaded applications is unsupported.
60
61
62
63SunOS 5.11                        30 Oct 2007                    scandir(3UCB)
Impressum