file_glob.h File Reference

File globbing (ala POSIX glob, but simpler) More...

#include <yaz/yconfig.h>
#include <stdio.h>

Go to the source code of this file.

Macros
#define	YAZ_FILE_GLOB_FAIL_NOTEXIST   1

Typedefs
typedef struct glob_res *	yaz_glob_res_t
	file glob handle

Functions
int	yaz_file_glob (const char *pattern, yaz_glob_res_t *res)
	perform glob
int	yaz_file_glob2 (const char *pattern, yaz_glob_res_t *res, unsigned flags)
	perform glob (with flags)
void	yaz_file_globfree (yaz_glob_res_t *res)
	release glob result
const char *	yaz_file_glob_get_file (yaz_glob_res_t res, size_t idx)
	return resulting matching file
size_t	yaz_file_glob_get_num (yaz_glob_res_t res)
	return number of matching files

Detailed Description

File globbing (ala POSIX glob, but simpler)

Definition in file file_glob.h.

Macro Definition Documentation

YAZ_FILE_GLOB_FAIL_NOTEXIST

#define YAZ_FILE_GLOB_FAIL_NOTEXIST   1

Definition at line 43 of file file_glob.h.

Typedef Documentation

yaz_glob_res_t

typedef struct glob_res* yaz_glob_res_t

file glob handle

Definition at line 41 of file file_glob.h.

Function Documentation

yaz_file_glob()

int yaz_file_glob	(	const char *	pattern,
		yaz_glob_res_t *	res
	)

perform glob

Parameters

pattern	glob pattern file spec
res	returned glob result

Return values

0	OK
-1	ERROR

Definition at line 141 of file file_glob.c.

References yaz_file_glob2().

yaz_file_glob2()

int yaz_file_glob2	(	const char *	pattern,
		yaz_glob_res_t *	res,
		unsigned	flags
	)

perform glob (with flags)

Parameters

pattern	glob pattern file spec
res	returned glob result
flags	YAZ_FILE_GLOB_.. flags

Return values

0	OK
-1	ERROR

Definition at line 146 of file file_glob.c.

References glob_r(), nmem_create(), nmem_malloc(), and sort_them().

Referenced by config_include_src(), and yaz_file_glob().

yaz_file_glob_get_file()

const char * yaz_file_glob_get_file	(	yaz_glob_res_t	res,
		size_t	idx
	)

return resulting matching file

Parameters

res	glob result
idx	index 0=first, .. N-1 (where N is yaz_file_glob_get_num)

Returns

file name or NULL if idx is out-of-range

Definition at line 173 of file file_glob.c.

References glob_res::entries, res_entry::file, and res_entry::next.

Referenced by config_include_src().

yaz_file_glob_get_num()

size_t yaz_file_glob_get_num

(

yaz_glob_res_t

res

)

return number of matching files

Parameters

res	glob result

Returns

number of files

Definition at line 186 of file file_glob.c.

References glob_res::number_of_entries.

yaz_file_globfree()

void yaz_file_globfree

(

yaz_glob_res_t *

res

)

release glob result

Parameters

res	pointer to glob result

A value of *res == NULL is allowed. If *res != NULL, then res is set to NULL

Definition at line 163 of file file_glob.c.

References nmem_destroy().

Referenced by config_include_src().