The Single UNIX ® Specification, Version 2
Copyright © 1997 The Open Group

 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() 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() 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(), the XCU specification.

UNIX ® is a registered Trademark of The Open Group.
Copyright © 1997 The Open Group
[ Main Index | XSH | XCU | XBD | XCURSES | XNS ]