Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] ftw, nftw - Parcours d'arborescence de fichiers. [size=18] [b]Résumé[/b] [/size] [b]#include <ftw.h>[/b] [b][i]int ftw (const char * directory , int (* funcptr )[/i][/b] [b][i](const char * file , const struct stat * sb , int flag ), int depth );[/i][/b] [b][i]int nftw (const char * directory , int (* funcptr )[/i][/b] [b][i](const char * file , const struct stat * sb , int flag ,[/i][/b] [b][i]struct FTW * s ),[/i][/b] [b][i]int depth , int flags );[/i][/b] [size=18] [b]Description[/b] [/size] La fonction [b]ftw[/b]() parcourt la hiérarchie de fichiers commençant au répertoire [i]directory[/i]. Pour chaque fichier rencontré, elle appelle [i]funcptr[/i] avec le chemin d'accès du fichier relativement à [i]directory[/i], un pointeur sur une structure [b]stat (2),[/b] et un entier [i]flag[/i], dont la valeur signifie : [b]FTW_F[/b] [table][row][col]    [/col][col]Fichier normal[/col][/row][/table] [b]FTW_D[/b] [table][row][col]    [/col][col]Répertoire[/col][/row][/table] [b]FTW_DNR[/b] [table][row][col]    [/col][col]Répertoire non lisible[/col][/row][/table] [b]FTW_SL[/b] [table][row][col]    [/col][col]Lien symbolique[/col][/row][/table] [b]FTW_NS[/b] [table][row][col]    [/col][col]Echec de stat sur cet élément[/col][/row][/table]     S'il s'agit d'un lien symbolique et que stat échoue, XPG4v2 précise que FTW_NS ou FTW_SL peuvent être utilisés. [b]ftw[/b]() s'appelle lui-même recursivement pour parcourir tous les répertoires trouvés. Afin d'éviter d'utiliser tous les descripteurs de fichiers disponibles pour le programme, la profondeur [i]depth[/i] limite le nombre de répertoires ouverts simultanément. Quand cette profondeur est atteinte, [b]ftw[/b]() va ralentir, car des répertoires devront être fermés puis réouverts. Pour arrêter le parcours des fichiers, la fonction [i]funcptr[/i] peut renvoyer une valeur non-nulle, qui deviendra la valeur de retour de [b]ftw[/b](). Sinon, [b]ftw[/b]() continuera jusqu'à atteindre la fin du parcours de l'arbre, et renverra zéro, ou jusqu'à ce que se produise une erreur comme celles de [b]malloc (3)[/b] et renverra -1. Comme [b]ftw()[/b] utilise des structures de données allouées dynamiquement, la seule manière propre de sortir d'un parcours est de renvoyer une valeur non nulle. Pour traiter les interruptions, par exemple, notez le numéro d'interruption survenue et renvoyez une valeur non nulle. N'utilisez jamais [b]longjmp (3)[/b] à moins que le programme ne soit prêt à se terminer. La fonction [b]nftw[/b]() fait exactement la même chose que [b]ftw[/b](), sauf qu'elle utilise un argument [i]flags[/i] supplémentaire (et invoque la fonction transmise avec un argument de plus). L'argument [i]flags[/i] est un OU regroupant zéro ou certaines des constantes : [b]FTW_CHDIR[/b] [table][row][col]    [/col][col]Faire un [b]chdir ()[/b] dans chaque répertoire avant d'en traiter le contenu.[/col][/row][/table] [b]FTW_DEPTH[/b] [table][row][col]    [/col][col]Faire une recherche en profondeur d'abord, c'est-à-dire n'appeler la fonction pour le répertoire lui-même qu'après en avoir traité tout le contenu, y compris les sous-répertoires.[/col][/row][/table] [b]FTW_MOUNT[/b] [table][row][col]    [/col][col]Rester uniquement dans le même système de fichiers.[/col][/row][/table] [b]FTW_PHYS[/b] [table][row][col]    [/col][col]Ne pas suivre les liens symboliques (C'est classiquement ce que l'on veut). Sinon, les liens symboliques sont suivis, mais aucun fichier n'est traité plus d'une fois.[/col][/row][/table]     Si FTW_PHYS n'est pas demandé, mais si FTW_DEPTH l'est, la fonction . IR funcptr () n'est jamais appelée sur un répertoire que l'on retrouve dans ses descendants.     La fonction [b]funcptr ()[/b] est appelée avec quatre arguments : le chemin de l'entrée traitée, un pointeur sur une structure stat la concernant, un entier décrivant son type, et un pointeur sur une structure FTW. Le type sera FTW_F, FTW_D, FTW_DNR, FTW_SL, ou FTW_NS (significations ci-dessus, FTW_SL uniquement si FTW_PHYS est demandé) ou [b]FTW_DP[/b] [table][row][col]    [/col][col]Répertoire dont tous les descendants on été déjà traités. Ceci ne se produit qu'avec FTW_DEPTH.[/col][/row][/table] [b]FTW_SLN[/b] [table][row][col]    [/col][col]Lien symbolique pointant nulle part. Ceci ne se produit qu'avec FTW_PHYS absent.[/col][/row][/table]     La structure FTW pointée par le quatrième argument de [b]funcptr ()[/b] contient au moins les champs [b]base ,[/b] la position du nom de fichier dans le chemin fourni par le premier argument de [b]funcptr (),[/b] et [b]level ,[/b] la profondeur de l'objet par rapport au point de départ (de profondeur 0). [size=18] [b]Notes[/b] [/size] La fonction [b]nftw ()[/b] et l'usage de FTW_SL dans [b]ftw ()[/b] ont été introduits dans XPG4v2.     Sur certains systèmes [b]ftw ()[/b] n'utilise jamais FTW_SL, sur d'autres FTW_SL ne se présente que pour les liens symboliques pointant dans le vide, sur d'autres encore [b]ftw ()[/b] utilisera FTW_SL pour chaque lien symbolique. Pour un fonctionnement prévisible, employez [b]nftw ().[/b]     Sous Linux, les LibC 4, LibC 5, et GlibC 2.0.6 utilisent FTW_F pour tous les objets (fichiers, liens symboliques, fifos, etc.) ne permettant pas un stat, mais autres que les répertoires. La fonction [b]nftw ()[/b] est disponible depuis la GlibC 2.1. [size=18] [b]Conformité[/b] [/size] AES, SVID2, SVID3, XPG2, XPG3, XPG4, XPG4v2. [size=18] [b]Voir aussi[/b] [/size] [b]stat (2)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier