Linux Certif

Toute la documentation sur la certification Linux LPI

basename

NON

basename, dirname - Analyse des composants d'un chemin d'accès.

SYNOPSIS

#include <libgen.h>



char *basename(char *chemin);

char *dirname(char *chemin);

DESCRIPTION

Les fonctions basename et dirname décomposent une chaîne terminée par un caractère nul, représentant un chemin d'accès en ses composants répertoire et nom de fichier. En général, dirname renvoie la chaîne s'étendant jusqu'au dernier '/', non compris, et basename renvoie la partie se trouvant après le dernier '/'. Les caractères '/' en fin de chaîne ne font pas partie du chemin.

Si le chemin ne contient pas de slash, dirname renvoie la chaîne "." et basename renvoie une copie de la chaîne chemin. Si le chemin est représenté par la chaîne "/", alors dirname et basename renvoient tout deux la chaîne "/". Si le chemin est un pointeur NULL, ou pointe vers une chaîne vide, alors dirname et basename renvoient tout deux la chaîne "."

En mettant bout à bout la chaîne renvoyée par dirname, un "/", et la chaîne renvoyée par basename, on obtient un chemin d'accès complet.

Autant dirname que basename peuvent modifier le contenu de la chaîne chemin, aussi si vous devez conserver la chaîne originale, il faut leur transmettre des copies de la chaîne. De plus, dirname et basename peuvent renvoyer des pointeurs sur des zones mémoires allouées statiquement, qui peuvent être écrasées par des appels consécutifs.

La liste suivante d'exemple (prise dans SUSv2) montre les chaînes renvoyées par dirname et basename pour différents chemin d'accès :

chemin      dirname  basename

"/usr/lib"  "/usr"   "lib"

"/usr/"     "/"      "usr"

"usr"       "."      "usr"

"/"         "/"      "/"

"."         "."      "."

".."        "."      ".."

EXEMPLE

char *dirc, *basec, *bname, *dname;

char *chemin = "/etc/passwd";



dirc = strdup(chemin);

basec = strdup(chemin);

dname = dirname(dirc);

bname = basename(basec);

printf("dirname=%s, basename=%s\n", dname, bname);

free(dirc);

free(basec);

VALEUR RENVOYÉE

Les fonctions dirname et basename renvoient des pointeurs sur des chaînes terminées par un caractère nul.

BOGUES

Dans les versions de la GlibC jusqu'à 2.2.1 comprise, dirname ne gérait pas correctement les chemins se terminant par un caractère '/' et déclenchait une erreur de segmentation en recevant un pointeur NULL.

CONFORMITÉ

SUSv2

VOIR AUSSI

dirname(1), basename(1),

TRADUCTION

Christophe Blaess, 2001-2003.