Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] glob, globfree - Rechercher un chemin d'accès correspondant à un motif. [size=18] [b]Résumé[/b] [/size] .nf [b]#include <glob.h>[/b] [b][i]int glob (const char * pattern , int flags ,[/i][/b] .nl [b][i] int (* errfunc) (const char * epath , int eerrno ),[/i][/b] .nl [b][i] glob_t pglob );[/i][/b] .nl [b][i]void globfree (glob_t pglob );[/i][/b] .fi [size=18] [b]Description[/b] [/size] La fonction [b]glob()[/b] recherche tous les chemins d'accès correspondants au motif [i]pattern[/i] en utilisant les règles du shell (voir [b]glob (7)).[/b] Aucun remplacement de tilde ou substitution de paramètre n'est effectué. Si vous avez besoin de ces fonctionnalités, voyez [b]wordexp (3).[/b] La fonction [b]globfree()[/b] libère la mémoire allouée dynamiquement lors d'un appel précédent à [b]glob() .[/b] Les résultats d'un appel à [b]glob()[/b] sont stockés dans une structure pointée par [b]pglob ,[/b] qui est du type [b]glob_t[/b] défini dans [b]<glob.h>[/b] en incluant les éléments définis par POSIX.2 (il peut y en avoir plus sous forme d'extension GNU) : [b][/b] .nf .in 10 typedef struct { .in 14 int gl_pathc; /* Nombre de chemins correspondant / char gl_pathv; / Liste des chemins correspondant / int gl_offs; / Entrées à réserver dans `gl_pathv'. / .in 10 } glob_t; .fi Le paramètre [i]flags[/i] est constitué d'un OU binaire (\|) entre zéro ou plus des constantes symboliques suivantes, modifiant le comportement de [b]glob() :[/b] [b]GLOB_ERR[/b] [table][row][col]    [/col][col]demande à [b]glob()[/b] de se terminer dès qu'une erreur se produit (par exemple un répertoire non lisible).[/col][/row][/table] [b]GLOB_MARK[/b] [table][row][col]    [/col][col]Ajouter un slash final à chaque nom aboutissant à un répertoire.[/col][/row][/table] [b]GLOB_NOSORT[/b] [table][row][col]    [/col][col]Ne pas trier les chemins d'accès renvoyés (ils le sont par défaut).[/col][/row][/table] [b]GLOB_DOOFFS[/b] [table][row][col]    [/col][col]signifie que [i]pglob->gl_offs[/i] points d'entrée seront réservés au début de la liste de chaînes dans [b]pglob->pathv .[/b][/col][/row][/table] [b]GLOB_NOCHECK[/b] [table][row][col]    [/col][col]demande à [b]glob()[/b] de renvoyer le motif original si aucune correspondance n'est possible.[/col][/row][/table] [b]GLOB_APPEND[/b] [table][row][col]    [/col][col]ajoute les résultats à ceux d'un appel précédent. Ne pas indiquer cet attribut lors du premier appel de [b]glob() .[/b][/col][/row][/table] [b]GLOB_NOESCAPE[/b] [table][row][col]    [/col][col]Les méta-caractères ne peuvent pas être désactivés par un backslash.[/col][/row][/table] On peut également utiliser les constantes suivantes, qui sont des extensions GNU, non définies dans POSIX.2 : [b]GLOB_PERIOD[/b] [table][row][col]    [/col][col]Un point en tête de chemin peut correspondre à un méta-caractère.[/col][/row][/table] [b]GLOB_ALTDIRFUNC[/b] [table][row][col]    [/col][col]On utilisera comme alternatives aux fonctions normales de bibliothèque les fonctions [b]pglob->gl_closedir ,[/b] [b]pglob->gl_readdir ,[/b] [b]pglob->gl_opendir ,[/b] [b]pglob->gl_lstat , et[/b] [b]pglob->gl_stat .[/b][/col][/row][/table] [b]GLOB_BRACE[/b] [table][row][col]    [/col][col]Les expressions de type [b]{a,b}[/b] sont développées avec le style [b]csh (1).[/b][/col][/row][/table] [b]GLOB_NOMAGIC[/b] [table][row][col]    [/col][col]Le motif est renvoyé s'il ne contient pas de méta-caractères.[/col][/row][/table] [b]GLOB_TILDE[/b] [table][row][col]    [/col][col]L'expansion du tilde est prise en charge.[/col][/row][/table] [b]GLOB_ONLYDIR[/b] [table][row][col]    [/col][col]Seuls les répertoires sont mis en correspondance.[/col][/row][/table] Si [i]errfunc[/i] n'est pas [b]NULL ,[/b] elle sera appelée en cas d'erreur, avec les arguments [i]epath[/i] un pointeur sur le chemin qui a échoué, et [b]eerrno[/b] la valeur de [i]errno[/i] telle qu'elle a été renvoyée par un appel à [b]opendir() , readdir() , ou stat() .[/b] Si [i]errfunc[/i] renvoie une valeur non nulle, ou si [b]GLOB_ERR[/b] est positionné, [b]glob()[/b] se terminera après l'appel de [b]errfunc .[/b] Si [b]glob()[/b] réussit complètement, [i]pglob->gl_pathc[/i] contient le nombre de chemins d'accès correspondants et [i]pglob->gl_pathv[/i] est un pointeur sur une liste des chemins. Le premier pointeur après le dernier chemin vaut [b]NULL .[/b] Il est possible d'appeler [b]glob()[/b] plusieurs fois. Dans ce cas, l'attribut [b]GLOB_APPEND[/b] doit être indiqué dans [i]flags[/i] durant le second appel et les suivants. En tant qu'extension GNU, le champ [i]pglob->gl_flags[/i] contient les attributs indiqués liés par un [b]OU[/b] avec [b]GLOB_MAGCHAR[/b] si un méta-caractère a été trouvé. [size=18] [b]Valeur renvoyée[/b] [/size] S'il réussit complètement [b]glob()[/b] renvoie zéro. Les autres valeurs renvoyées peuvent être : [b]GLOB_NOSPACE[/b] [table][row][col]    [/col][col]pas assez de mémoire,[/col][/row][/table] [b]GLOB_ABORTED[/b] [table][row][col]    [/col][col]erreur de lecture,[/col][/row][/table] [b]GLOB_NOMATCH[/b] [table][row][col]    [/col][col]aucune correspondance trouvée.[/col][/row][/table] [size=18] [b]Exemples[/b] [/size] L'exemple d'utilisation suivant simule la frappe de .nl [b]ls -l .c ../.c[/b] .nl dans un shell. .nf .in 10 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]); .fi [size=18] [b]Conformité[/b] [/size] POSIX.2 [size=18] [b]Bugs[/b] [/size] La fonction [b]glob()[/b] peut échouer en cas d'erreur dans un appel de fonction sous-jacente, comme [b]malloc() ou opendir() .[/b] Le code d'erreur sera alors stocké dans [b]errno .[/b] [size=18] [b]Notes[/b] [/size] Les membres [i]gl_pathc[/i] et [i]gl_offs[/i] de la structure glob_t sont des [b]size_t [/b] dans GlibC 2.1, comme indiqué dans POSIX.2, mais sont déclarés sous forme de [b]int [/b] dans LibC 4, LibC 5 et GlibC 2.0. [size=18] [b]Voir aussi[/b] [/size] [b]ls (1),[/b] [b]sh (1),[/b] [b]stat (2),[/b] [b]exec (3),[/b] [b]malloc (3),[/b] [b]opendir (3),[/b] [b]readdir (3),[/b] [b]wordexp (3),[/b] [b]glob (7)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier