summaryrefslogtreecommitdiff
path: root/reference/C/MAN/scandir.htm
blob: a9c98175a5b641279f15a1b36fbf01b155126a7f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
<TITLE>scandir</TITLE>
<body bgcolor="#ffffcc">
<hr>
<pre>



<h3>SCANDIR(3)          Linux Programmer's Manual          SCANDIR(3)
</h3>

<h3>NAME
</h3>       scandir, alphasort - scan a directory for matching entries

<h3>SYNOPSIS
</h3>       #include &lt;dirent.h&gt;

       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);

<h3>DESCRIPTION
</h3>       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.

<h3>RETURN VALUE
</h3>       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.

<h3>ERRORS
</h3>       ENOMEM Insufficient memory to complete the operation.

<h3>CONFORMING TO
</h3>       BSD 4.3

</pre>
<hr>
<h3>SEE ALSO
</h3><p>
<a href=opendir.htm>opendir</a>, 
<a href=readdir.htm>readdir</a>, 
<a href=closedir.htm>closedir</a>, 
<a href=rewinddir.htm>rewinddir</a>, 
<a href=telldir.htm>telldir</a>, 
<a href=seekdir.htm>seekdir</a>, 
<pre>














<h3>GNU                       March 31, 1993                        1
</h3>


</pre>
<P>
<hr>
<p>
<center>
<table border=2 width=80%>
<tr align=center>
<td width=25%>
<a href=../cref.html>Top</a>
</td><td width=25%>
<a href=../master_index.html>Master Index</a>
</td><td width=25%>
<a href=../SYNTAX/keywords.html>Keywords</a>
</td><td width=25%>
<a href=../FUNCTIONS/funcref.htm>Functions</a>
</td>
</tr>
</table>
</center>
<p>
<hr>

This manual page was brought to you by <i>mjl_man V-2.0</i>