NAME
glob.h — pathname
pattern-matching types
SYNOPSIS
#include <glob.h>
DESCRIPTION
The <glob.h> header defines the
structures and symbolic constants used by the glob(3)
function.
The structure type contains 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 are 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
- GLOB_ERR
- Cause glob(3) 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 are defined as error return values:
- GLOB_ABORTED
- The scan was stopped because GLOB_ERR was set or 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
- The implementation does not support this function.
The following are declared as functions and may also be declared
as macros. Function prototypes must be provided for use with an ISO C
compiler. int glob(const char *, int, int (*)(const char *,
int), glob_t *); void globfree (glob_t *);
The implementation may define additional macros or constants using names beginning with GLOB_.
APPLICATION USAGE
None.
FUTURE DIRECTIONS
None.
SEE ALSO
glob(3) , the XCU specification.