Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] getcwd, get_current_dir_name, getwd - Obtenir le répertoire courant. [size=18] [b]Résumé[/b] [/size] .nf [b]#include <unistd.h>[/b] [b][i]char * getcwd (char * buf , size_t size );[/i][/b] [b] char * get_current_dir_name (void);[/b] [b][i]char * getwd (char * buf );[/i][/b] .fi [size=18] [b]Description[/b] [/size] La fonction [b]getcwd ()[/b] copie le chemin d'accès absolu du répertoire de travail courant dans la chaîne pointée par [b]buf ,[/b] qui est de longueur [b]size .[/b] Si le chemin du répertoire en cours nécessite un buffer plus long que [i]size[/i] octets, la fonction renvoie [b]NULL ,[/b] et [i]errno[/i] contient le code d'erreur [b]ERANGE .[/b] Une application doit détecter cette erreur et allouer un buffer plus grand si besoin est. Si [i]buf[/i] est NULL, le comportement de [b]getcwd ()[/b] est indéfini. Comme extension du standard POSIX.1, la version Linux (LibC4, LibC5, GlibC) de [b]getcwd()[/b] alloue le buffer dynamiquement, en utilisant [b]malloc (),[/b] si [i]buf[/i] est [b]NULL[/b] lors de l'appel. Alors, le buffer alloué a la longueur [i]size[/i] à moins que [i]size[/i] soit inférieure à zéro, dans ce cas [i]buf[/i] a la taille nécessaire. Il est possible (et même fortement conseillé) de libérer le buffer avec [b]free()[/b] lorsqu'il a été obtenu ainsi. [b]get_current_dir_name ,[/b] qui ne possède un prototype que si la constante [b]_GNU_SOURCE[/b] est définie, allouera avec [b]malloc (3)[/b] une chaîne suffisament grande pour contenir le nom du répertoire. Si la variable d'environnement [b]PWD[/b] est configurée, et correcte, cette valeur sera renvoyée. [b]getwd ,[/b] qui ne possède un prototype que si les constantes [b]_BSD_SOURCE[/b] ou [b]_XOPEN_SOURCE_EXTENDED[/b] sont définies, n'allouera aucune mémoire. L'argument [i]buf[/i] doit être un pointeur sur une chaîne comportant au moins [b]PATH_MAX[/b] octets. [b]getwd[/b] ne renverra que les [b]PATH_MAX[/b] premiers octets du nom réel. Notez que [b]PATH_MAX[/b] n'est pas nécessairement une constante à la compilation. Elle peut dépendre du système de fichiers, voire être illimitée. Pour des raisons de portabilité et de sécuriré, on déconseille l'utilisation de [b]getwd .[/b] [size=18] [b]Valeur renvoyée[/b] [/size] [b]NULL[/b] en cas d'échec, avec [i]errno[/i] contenant le code d'erreur. En cas de réussite [i]buf[/i] est renvoyé. Le contenu de la chaîne pointée par [i]buf[/i] est indéfini en cas d'erreur. [size=18] [b]Erreurs[/b] [/size] [b]EACCES[/b] [table][row][col]    [/col][col]Impossible de lire ou de parcourir un composant du chemin d'accès.[/col][/row][/table] [b]EFAULT[/b] [b]buf[/b] [table][row][col]    [/col][col]pointe sur une adresse illégale.[/col][/row][/table] [b]EINVAL[/b] [table][row][col]    [/col][col]L'argument [b]size [/b] vaut zéro et [b]buf[/b] n'est pas un pointeur NULL.[/col][/row][/table] [b]ENOENT[/b] [table][row][col]    [/col][col]Le répertoire en cours a été supprimé.[/col][/row][/table] [b]ERANGE[/b] [table][row][col]    [/col][col]L'argument [b]size [/b] est inférieur à la longueur du nom du répertoire. Allouez un buffer plus grand et ré-essayez.[/col][/row][/table] [size=18] [b]Notes[/b] [/size] Sous Linux, la fonction [b]getcwd ()[/b] est un appel-système (depuis le 2.1.92). Sur des systèmes plus anciens, elle interrogerait [b]/proc/self/cwd .[/b] Si l'appel-système et le système de fichiers proc sont absents, une implémentation générique est utilisée. Dans ce cas seulement la fonction peut renvoyer [b]EACCES[/b] sous Linux.     Ces fonctions sont souvent utilisées pour sauver le répertoire de travail afin d'y revenir plus tard. Ouvrir le répertoire courant (".") et appeler [b]fchdir (2)[/b] pour y revenir est habituellement une alternative plus rapide et plus fiable (surtout sur d'autres systèmes que Linux) si l'on dispose de suffisament de descripteurs de fichiers. [size=18] [b]Conformité[/b] [/size] POSIX.1 [size=18] [b]Voir aussi[/b] [/size] [b]chdir (2),[/b] [b]fchdir (2),[/b] [b]open (2),[/b] [b]unlink (2),[/b] [b]free (3),[/b] [b]malloc (3)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier