Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] confstr - Lire une chaîne de caractères dépendant de la configuration. [size=18] [b]Résumé[/b] [/size] .nf [b]#define _POSIX_C_SOURCE 2[/b] or [b]#define _XOPEN_SOURCE[/b] .nl [b]#include <unistd.h>[/b] [b][i]size_t confstr (int name , char * buf , size_t len );[/i][/b] .fi [size=18] [b]Description[/b] [/size] La fonction [b]confstr ()[/b] fournit la valeur d'une chaîne de caractères dépendante de la configuration. L'argument [i]name[/i] est la variable système réclamée. Les variables suivantes sont supportées : [b]_CS_PATH[/b] [table][row][col]    [/col][col]Une valeur de la variable [b]PATH[/b] indiquant les emplacements ou les utilitaires standards POSIX.2 peuvent être trouvés.[/col][/row][/table] Si [i]buf[/i] n'est pas [b]NULL ,[/b] et si [i]len[/i] est différent de 0, alors [b]confstr ()[/b] copie la valeur de la chaîne dans le buffer [b]buf ,[/b] en limitant la longueur à [i]len - 1[/i] caractères, terminée par un caractère nul. On peut détecter la troncature de la chaîne en comparant le résultat de [b]confstr ()[/b] avec le paramètre [b]len .[/b] Si [i]len[/i] est nulle, et si [i]buf[/i] vaut [b]NULL ,[/b] alors [b]confstr ()[/b] renvoie simplement la longueur de la variable système. [size=18] [b]Valeur renvoyée[/b] [/size] Si [i]name[/i] ne correspond à aucune variable de configuration valide, [b]confstr ()[/b] renvoie 0. [size=18] [b]Exemples[/b] [/size] Le fragment de code ci-dessous détermine le chemin d'accès aux utilitaires POSIX.2 : [b][/b] .nf .in 10 char *pathbuf; size_t n; n = confstr(_CS_PATH,NULL,(size_t)0); if ((pathbuf = malloc(n)) == NULL) abort(); confstr(_CS_PATH, pathbuf, n); [size=18] [b]Erreurs[/b] [/size] Si la valeur de [i]name[/i] est invalide, [i]errno[/i] contient [b]EINVAL .[/b] [size=18] [b]Conformité[/b] [/size] proposition POSIX.2 [size=18] [b]Bugs[/b] [/size] POSIX.2 n'est pas encore un standard établi, les informations contenues dans cette page de manuel peuvent changer. [size=18] [b]Voir aussi[/b] [/size] [b]sh (1),[/b] [b]exec (3),[/b] [b]system (3)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier