al_findfirst
Low-level function for searching files.
Description
Low-level function for searching files. This function finds the first
file which matches the given wildcard specification and file attributes
(see above). The information about the file (if any) will be put in the
al_ffblk structure which you have to provide. The al_ffblk structure
looks like:
struct al_ffblk
{
int attrib; - actual attributes of the file found
time_t time; - modification time of file
char name[512]; - name of file
};
There is some other stuff in the structure as well, but it is there for
internal use only. Example:
struct al_ffblk info;
if (al_findfirst("*.pcx", &info, FA_ALL) != 0) {
/* Tell user there are no PCX files. */
return;
}
The function returns non-zero if no match is found or if an error occurred
and, in the latter case, sets `errno' accordingly. It returns zero if a
match is found, allocating some memory for internal use in the structure.
Therefore you have to close your search when you are finished to avoid
memory leaks in your program.
Related Discussions
The following threads each have code containing this keyword:
Note: You can click on the numbers to jump directly to the posts that reference this page.
Related Projects
The following projects include source code containing this keyword:
