# glob.h - [Overview](#section828651866165627) - [Summary](#section1427259795165627) - [Data Structures](#nested-classes) - [Macros](#define-members) - [Functions](#func-members) ## **Overview** **Related Modules:** [FS](fs.md) **Description:** Provides functions and structures used to find path names matching a pattern and release the memory that was applied for during the search. **Since:** 1.0 **Version:** 1.0 ## **Summary** ## Data Structures

Data Structure Name	Description
glob_t	Defines the search information.

## Macros

Macro Name and Value	Description
GLOB_ERR 0x01	Return upon a read error.
GLOB_MARK 0x02	Append a slash (/) to each path, which corresponds to a directory.
GLOB_NOSORT 0x04	Do not sort the returned path names.
GLOB_DOOFFS 0x08	In the pglob parameter of the glob() function, reserve a string that has a length of pglob->gl_offs and ends with \0 at the beginning of the string list in pglob->pathv. That is, the newly matched string is appended to a position where the distance from the beginning of pglob->pathv is the length of pglob->gl_offs.
GLOB_NOCHECK 0x10	If no pattern matches, return the original pattern.
GLOB_APPEND 0x20	Append the results of this call to the results returned by a previous call to glob().
GLOB_NOESCAPE 0x40	Do not use a backslash () as an escape character.
GLOB_PERIOD 0x80	Allow a leading period to be matched by metacharacters.
GLOB_TILDE 0x1000	Carry out tilde expansion. If a tilde (~) is the only character in the pattern, or an initial tilde is followed immediately by a slash (/), then the home directory of the caller is substituted for the tilde.
GLOB_TILDE_CHECK 0x4000	Similar to GLOB_TILDE. The difference is that if the username is invalid, or the home directory cannot be determined, glob() returns GLOB_NOMATCH to indicate an error.
GLOB_NOSPACE 1	Memory insufficient.
GLOB_ABORTED 2	Read error.
GLOB_NOMATCH 3	No matching item is found.
GLOB_NOSYS 4	The function is not supported.

## Functions

Function	Description
glob (const char __restrict pattern, int flags, int(errfunc)(const char , int), glob_t __restrict pglob)	int Searches for path names that meet a specified pattern.
globfree (glob_t *pglob)	void Frees allocated memory from a call to glob().

Function

Description

glob (const char *__restrict pattern, int flags, int(*errfunc)(const char *, int), glob_t *__restrict pglob)

int

Searches for path names that meet a specified pattern.

globfree (glob_t *pglob)

void

Frees allocated memory from a call to glob().