glob(5)


glob -- pathname pattern-matching utilities

Synopsis

   #include <glob.h> 

Description

The glob.h header declares the type glob_t which includes the following members:

size_t gl_pathc
Number of paths pattern matches

char **gl_pathv
A pointer to a list of pathnames that have been matched

size_t gl_offs
Slots to be reserved. Found at the beginning of gl_pathv

The following functions are declared:

   int glob(const char *pattern, int flags,
            int (*errfunc)(const char *epath, int eerrno),
            glob_t *pglob);
   

void globfree (glob_t *pglob);

The flags argument requires a set of values. The following constants are provided as values for flag:


GLOB_APPEND
Append newly formed pathnames to previously obtained ones

GLOB_DOOFFS
A specification of the number of null pointers that should be added to the start of pglob-> gl_pathv

GLOB_ERR
This is to ensure that if an error occurs, glob is returned

GLOB_MARK
A slash is appended to each directory pathname matching pattern

GLOB_NOCHECK
If there is no match between a pathname and pattern then a list is returned which contains pattern only

GLOB_NOESCAPE
disable backslash escaping

GLOB_NOSORT
Pathnames that are returned are not to be sorted

Error return values have the following constants defined:


GLOB_ABORTED
Because (*errfunc) returned zero or GLOB_ERR was set, scanning was terminated.

GLOB_NOMATCH
There is no match between the pattern and any pathname that exists. GLOB_NOCHECK was not set in flags.

GLOB_NOSPACE
Memory allocation failure

GLOB_NOSYS
Function not supported by this implementation.

© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004