Шрифт:
void (*gl_closedir)(DIR *); /* Частная версия closedir */
struct dirent *(*gl_readdir)(DIR *); /* Частная версия readdir)) */
DIR *(*gl_opendir)(const char *); /* Частная версия opendir)) */
int (*gl_lstat)(const char *, struct stat *);
/* Частная версия lstat */
int (*gl_stat)(const char *, struct stat *); /* Частная версия stat */
} glob_t;
Члены структуры следующие:
int gl_flags
Копия флагов. Включает также
GLOB_MAGCHAR
, если pattern
включал какие-либо метасимволы.
void (*gl_closedir)(DIR *)
Указатель на альтернативную версию
closedir
.
struct dirent *(*gl_readdir)(DIR *)
Указатель на альтернативную версию
readdir
.
DIR *(*gl_opendir)(const char *)
Указатель на альтернативную версию
opendir
.
int (*gl_lstat)(const char *, struct stat*)
Указатель на альтернативную версию
lstat
.
int (*gl_stat)(const char*, struct stat*)
Указатель на альтернативную версию
stat
. Указатели на альтернативные версии стандартных функций предназначены главным образом для использования в реализации GLIBC; крайне маловероятно, что вы когда-нибудь их используете. Поскольку GLIBC предусматривает поле
gl_flags
и дополнительные значения флагов, справочная страница и руководство Info документируют оставшуюся часть структуры GLIBC glob_t
. В табл. 12.3 перечислены дополнительные флаги. Таблица 12.3. Дополнительные флаги GLIBC для
glob
| Флаг | Значение |
|---|---|
| GLOB_ALTDIRFUNC | Использовать для доступа к каталогам альтернативные функции (см. текст) |
| GLOB_BRACE | Выполнить раскрытие фигурных скобок в стиле csh и Bash. |
| GLOB_MAGCHAR | Вставить gl_flags , если были найдены метасимволы. |
| GLOB_NOMAGIC | Вернуть шаблон, если он не содержит метасимволов |
| GLOB_ONLYDIR | По возможности сопоставлять лишь каталоги. См. текст. |
| GLOB_PERIOD | Разрешить соответствие метасимволов наподобие * и ? начальной точке |
| GLOB_TILDE | Выполнить раскрывание тильды в стиле оболочки. |
| GLOB_TILDE_CHECK | Подобно GLOB_TILDE , но если есть проблемы с указанным домашним каталогом, вернуть GLOB_NOMATCH вместо помещения pattern в список. |
Флаг
GLOB_ONLYDIR
действует в качестве подсказки реализации, потому что вызывающий интересуется лишь каталогами. Главным его предназначением является использование другими функциями в GLIBC, а вызывающий по-прежнему должен быть готов обрабатывать файлы, не являющиеся каталогами. Вам не следует использовать этот флаг в своих программах. glob
может быть вызвана более одного раза: при первом вызове флаг GLOB_APPEND
не должен быть указан, при всех последующих вызовах он должен быть указан. Вы не можете между вызовами изменять gl_offs
, а если вы изменили какие-нибудь значения в gl_pathv
или gl_pathc
, нужно их восстановить перед последующим вызовом glob
. Возможность многократного вызова
glob
позволяет накапливать результаты в одном списке. Это довольно практично, приближается к мощным возможностям раскрывания групповых символов оболочки, но на уровне языка программирования С. glob
возвращает 0, если не было проблем, или одно из значений из табл. 12.4, если были. Таблица 12.4. Возвращаемые
glob
значения | Флаг | Значение |
|---|---|
| GLOB_ABORTED | Просмотр остановлен раньше времени, поскольку был установлен GLOB_ERR или функция (*errfunc) возвратила ненулевой результат |
| GLOB_NOMATCH | Ни одно имя файла не соответствовало pattern , а флаг GLOB_NOCHECK не был установлен |
| GLOB_NOSPACE | Была проблема с выделением динамической памяти |
globfree
освобождает всю память, которую динамически выделила glob
Следующая программа, ch12-glob.с
, демонстрирует glob
:
1 /* ch12-glob.c --- демонстрирует glob. */
2
3 #include <stdio.h>
4 #include <errno.h>
5 #include <glob.h>
6
7 char *myname;
8
9 /* globerr --- выводит сообщение об ошибке для glob */
10
11 int globerr(const char *path, int eerrno)
12 {
13 fprintf(stderr, "%s: %s: %s\n", myname, path, strerror(eerrno));
14 return 0; /* let glob keep going */
15 }
16
17 /* main --- раскрывает символы подстановки в командной строке и выводит результаты */