The <glob.h> header shall define the structures and symbolic
constants used by the glob() function.
The structure type glob_t shall contain at least the following
members:
size_t gl_pathc Count of paths matched by pattern.
char **gl_pathv Pointer to a list of matched pathnames.
size_t gl_offs Slots to reserve at the beginning of gl_pathv.
The following constants shall be provided as values for the flags
argument:
|
|
GLOB_APPEND
|
| |
Append generated pathnames to those previously obtained.
|
|
GLOB_DOOFFS
|
| |
Specify how many null pointers to add to the beginning of gl_pathv.
|
|
GLOB_ERR
|
| |
Cause glob() to return on error.
|
|
GLOB_MARK
|
| |
Each pathname that is a directory that matches pattern has a
slash appended.
|
|
GLOB_NOCHECK
|
| |
If pattern does not match any pathname, then return a list consisting
of only pattern.
|
|
GLOB_NOESCAPE
|
| |
Disable backslash escaping.
|
|
GLOB_NOSORT
|
| |
Do not sort the pathnames returned.
|
|
The following constants shall be defined as error return values:
|
|
GLOB_ABORTED
|
| |
The scan was stopped because GLOB_ERR was set or (*errfunc)()
returned non-zero.
|
|
GLOB_NOMATCH
|
| |
The pattern does not match any existing pathname, and GLOB_NOCHECK
was not set in flags.
|
|
GLOB_NOSPACE
|
| |
An attempt to allocate memory failed.
|
|
GLOB_NOSYS
|
| |
Reserved.
|
|
The following shall be declared as functions and may also be defined
as macros. Function prototypes shall be provided.
int glob(const char *restrict, int, int (*)(const char *, int),
glob_t *restrict);
void globfree (glob_t *);
The implementation may define additional macros or constants using
names beginning with GLOB_.
The following sections are informative.