CONFSTR
Section: Manuel du programmeur Linux (3) Updated: 21 juillet 2003 Index
NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
EXEMPLES
ERREURS
CONFORMITÉ
BOGUES
VOIR AUSSI
TRADUCTION
NOM
confstr - Lire une chaîne de caractères dépendant de la configuration.
SYNOPSIS
#define _POSIX_C_SOURCE 2
or
#define _XOPEN_SOURCE
#include <unistd.h>
size_t confstr (int name, char *buf, size_t len);
DESCRIPTION
La fonction
confstr()
fournit la valeur d'une chaîne de caractères dépendante de la configuration.
L'argument
name
est la variable système réclamée.
Les variables suivantes sont supportées :
- _CS_PATH
-
Une valeur de la variable
PATH
indiquant les emplacements ou les
utilitaires standards POSIX.2 peuvent être trouvés.
Si
buf
n'est pas
NULL,
et si
len
est différent de 0, alors
confstr()
copie la valeur de la chaîne dans le buffer
buf,
en limitant la longueur à
len - 1
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
confstr()
avec le paramètre
len.
Si
len
est nulle, et si
buf
vaut
NULL,
alors
confstr ()
renvoie simplement la longueur de la variable système.
VALEUR RENVOYÉE
Si
name
ne correspond à aucune variable de configuration valide,
confstr()
renvoie 0.
EXEMPLES
Le fragment de code ci-dessous détermine le chemin d'accès aux utilitaires
POSIX.2 :
char *pathbuf; size_t n;
n = confstr(_CS_PATH,NULL,(size_t)0);
if ((pathbuf = malloc(n)) == NULL) abort();
confstr(_CS_PATH, pathbuf, n);
ERREURS
Si la valeur de
name
est invalide,
errno
contient
EINVAL.
CONFORMITÉ
proposition POSIX.2
BOGUES
POSIX.2 n'est pas encore un standard établi, les informations contenues dans
cette page de manuel peuvent changer.
VOIR AUSSI
TRADUCTION
Christophe Blaess, 1996-2003.
|