getcwd, get_current_dir_name, getwd − Obtenir le répertoire courant.

#include <unistd.h>

char * getcwd (char * buf, size_t size);
char * get_current_working_dir_name (void);
char * getwd (char * buf);

La fonction getcwd() copie le chemin d’accès absolu du répertoire de travail courant dans la chaîne pointée par buf, qui est de longueur size.

Si le chemin du répertoire en cours nécessite un buffer plus long que size octets, la fonction renvoie NULL, et errno contient le code d’erreur ERANGE. Une application doit détecter cette erreur et allouer un buffer plus grand si besoin est.

Si buf est NULL, le comportement de getcwd() est indéfini.

Comme extension du standard POSIX.1, la version Linux (LibC4, LibC5, GlibC) de getcwd() alloue le buffer dynamiquement, en utilisant malloc(), si buf est NULL lors de l’appel. Alors, le buffer alloué a la longueur size à moins que size soit inférieure à zéro, dans ce cas buf a la taille nécessaire. Il est possible (et même fortement conseillé) de libérer le buffer avec free() lorsqu’il a été obtenu ainsi.

get_current_dir_name, qui ne possède un prototype que si la constante _GNU_SOURCE est définie, allouera avec malloc(3) une chaîne suffisament grande pour contenir le nom du répertoire. Si la variable d’environnement PWD est configurée, et correcte, cette valeur sera renvoyée.

getwd, qui ne possède un prototype que si les constantes _BSD_SOURCE ou _XOPEN_SOURCE_EXTENDED sont définies, n’allouera aucune mémoire. L’argument buf doit être un pointeur sur une chaîne comportant au moins PATH_MAX octets. getwd ne renverra que les PATH_MAX premiers octets du nom réel.

NULL en cas d’échec (par exemple si le répertoire en cours n’est pas lisible), avec errno contenant le code d’erreur. En cas de réussite buf est renvoyé. Le contenu de la chaîne pointée par buf est indéfini en cas d’erreur.

POSIX.1

chdir(2), free(3), malloc(3).

Christophe Blaess, 1997.