glob | Début | Suivant | Sommaire | Préc.page.lue | Accueil |
NOM | Début | Précédent | Suivant | Sommaire | Préc.page.lue | Accueil |
SYNOPSIS | Début | Précédent | Suivant | Sommaire | Préc.page.lue | Accueil |
#include <glob.h> int (*errfunc) (const char *epath, int eerrno),
int (* errfunc)(const char * epath, int eerrno),
glob_t *pglob);
void globfree (glob_t *pglob);
DESCRIPTION | Début | Précédent | Suivant | Sommaire | Préc.page.lue | Accueil |
La fonction globfree() libère la mémoire allouée dynamiquement lors d'un appel précédent à glob().
Les résultats d'un appel à glob() sont stockés dans une structure pointée par pglob. Cette structure est de type glob_t (définie dans <glob.h>) en incluant les éléments définis par POSIX.2 (il peut y en avoir plus sous forme d'extension GNU) :
typedef struct { int gl_pathc; /* Nombre de chemins correspondant */ char **gl_pathv; /* Liste des chemins correspondant */ int gl_offs; /* Entrées à réserver dans gl_pathv. */ } glob_t;
Le paramètre flags est constitué d'un OU binaire « | » entre zéro ou plus des constantes symboliques suivantes, modifiant le comportement de glob() :
flags peut également inclure les constantes suivantes, qui sont des extensions GNU, non définies dans POSIX.2 :
Si errfunc n'est pas NULL, elle sera appelée en cas d'erreur, avec les arguments epath un pointeur sur le chemin qui a échoué, et errno la valeur de errno telle qu'elle a été renvoyée par un appel à opendir(3), readdir(3) ou stat(2). Si errfunc renvoie une valeur non nulle, ou si GLOB_ERR est positionné, glob() se terminera après l'appel de errfunc.
Si glob() réussit complètement, pglob->gl_pathc contient le nombre de chemins d'accès correspondants et pglob->gl_pathv contient un pointeur vers une liste de pointeurs sur les chemins qui correspondent. La liste des pointeurs est terminée par un pointeur NULL.
Il est possible d'appeler glob() plusieurs fois. Dans ce cas, l'attribut GLOB_APPEND doit être indiqué dans flags durant le second appel et les suivants.
En tant qu'extension GNU, le champ pglob->gl_flags contient les attributs indiqués liés par un OU avec GLOB_MAGCHAR si un méta-caractère a été trouvé.
VALEUR RENVOYÉE | Début | Précédent | Suivant | Sommaire | Préc.page.lue | Accueil |
CONFORMITÉ | Début | Précédent | Suivant | Sommaire | Préc.page.lue | Accueil |
NOTES | Début | Précédent | Suivant | Sommaire | Préc.page.lue | Accueil |
BOGUES | Début | Précédent | Suivant | Sommaire | Préc.page.lue | Accueil |
EXEMPLE | Début | Précédent | Suivant | Sommaire | Préc.page.lue | Accueil |
ls -l *.c ../*.c
dans un shell :
glob_t globbuf; globbuf.gl_offs = 2; glob("*.c", GLOB_DOOFS, NULL, &globbuf); glob("../*.c", GLOB_DOOFS | GLOB_APPEND, NULL, &globbuf); globbuf.gl_pathv[0] = "ls"; globbuf.gl_pathv[1] = "-l"; execvp("ls", &globbuf.gl_pathv[0]);
VOIR AUSSI | Début | Précédent | Suivant | Sommaire | Préc.page.lue | Accueil |
TRADUCTION | Début | Précédent | Suivant | Sommaire | Préc.page.lue | Accueil |
Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 3 novembre 1996 et révisée le 29 décembre 2007.
L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 glob ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.
Sommaire | Début | Suivant | Sommaire | Préc.page.lue | Accueil |
Table des mots clés | Début | Suivant | Sommaire | Préc.page.lue | Accueil |
GLOB_ABORTED | VALEUR RENVOYÉE |
GLOB_ALTDIRFUNC | DESCRIPTION |
GLOB_APPEND | DESCRIPTION |
GLOB_BRACE | DESCRIPTION |
GLOB_DOOFFS | DESCRIPTION |
GLOB_ERR | DESCRIPTION |
GLOB_MARK | DESCRIPTION |
GLOB_NOCHECK | DESCRIPTION |
GLOB_NOESCAPE | DESCRIPTION |
GLOB_NOMAGIC | DESCRIPTION |
GLOB_NOMATCH | VALEUR RENVOYÉE |
GLOB_NOSORT | DESCRIPTION |
GLOB_NOSPACE | VALEUR RENVOYÉE |
GLOB_ONLYDIR | DESCRIPTION |
GLOB_PERIOD | DESCRIPTION |
GLOB_TILDE | DESCRIPTION |
GLOB_TILDE_CHECK | DESCRIPTION |