path: Filename manipulation functions


Defines

#define PATH_MATCH_DOTFILES   1

Functions

int path_merge (str *path, const char *start)
int fnmatch (const char *filename, const char *pattern, unsigned options)
int has_magic (const char *s)
int path_match (const char *pattern, str *result, unsigned options)
int path_contains (const char *path, const char *part)
int path_mktemp (const char *prefix, str *filename)
int path_mkdirs (const char *path, unsigned mode)

Define Documentation

#define PATH_MATCH_DOTFILES   1

Make path_match include files starting with dots.


Function Documentation

int fnmatch ( const char *  filename,
const char *  pattern,
unsigned  options 
)

Matches a path using glob patterns.

int has_magic ( const char *  s  ) 

Does the string have glob characters in it.

Returns true if the given string contains at least one instance of either *, ?, or [.

int path_contains ( const char *  path,
const char *  part 
)

Test if a path contains a component.

Returns true if the path contains part either at the start followed by a slash, at the end preceded by a slash, or elsewhere with a slash on either side.

int path_match ( const char *  pattern,
str result,
unsigned  options 
)

Matches the pattern against existing files.

This function produces a list of existing files in result (in the current directory) that match the given pattern. If options has PATH_MATCH_DOTFILES set, the result may contain paths starting with ".".

int path_merge ( str path,
const char *  start 
)

Merge two paths together.

This function takes a starting path, and merges the second path into it. If the second path starts with a "/", it replaces the existing path completely. If the second path contains any ".." components, the preceding directory component in the current path (if any) is removed. All "." components are removed.

The effects of this function are equivalent to changing directory to the first path and then using the second one.

int path_mkdirs ( const char *  path,
unsigned  mode 
)

Create a directory, optionally creating any parent directories.

This function creates the named directory using mkdir. If any of the parent directories of the specified path do not exist, they are created as well (with the same mode).

Note:
Unlike the "<tt>mkdir -p</tt>" command, this function will result in an error if the path already exists.

int path_mktemp ( const char *  prefix,
str filename 
)

Create a temporary file.

This function creates a temporary file by adding an difficult-to-predict suffix (using the PID and microsecond timestamp) to the given prefix. If this filename does not exist, it is opened in read/write mode.


Generated on Thu Feb 19 11:11:50 2009 for bglibs by  doxygen 1.5.4