CATGETS
Section : Manuel du programmeur Linux (
3)
Mise à jour de la version anglaise : 9 août 1998
Index
Menu principal
NOM
catgets - Obtenir un message contenu dans un catalogue
SYNOPSIS
#include <nl_types.h>
char *catgets(nl_catd catalog, int set_number, int message_number,
const char *message);
DESCRIPTION
catgets()
lit le message numéro
message_number,
dans la section
set_number,
d'un catalogue de messages identifié par
catalog.
Ce dernier est un descripteur de catalogue renvoyé par
un appel précédent à
catopen(3).
Le quatrième argument,
message
pointe sur une chaîne de caractères par défaut qui sera renvoyée par
catgets()
si le catalogue indiqué n'est pas accessible.
Le texte du message renvoyé est contenu dans un tampon interne,
et doit être recopié par l'application si l'on désire le modifier,
ou le sauvegarder.
La chaîne renvoyée se termine toujours par un octet nul.
VALEUR RENVOYÉE
S'il réussit,
catgets()
renvoie un pointeur sur un tampon interne contenant le message,
terminé par un octet nul.
S'il échoue,
catgets()
renvoie un pointeur sur l'argument
message.
CONFORMITÉ
POSIX.1-2001.
NOTES
Ces fonctions ne sont disponibles qu'à partir
de la version 4.4.4c de libc.so.
Le Guide de Portabilité X/Open de janvier 1987
indique un retour d'erreur plus subtile :
message
est renvoyé si le catalogue indiqué par l'argument
catalog
n'est pas disponible, et une chaîne vide si le
catalogue est disponible mais ne contient pas le message demandé.
Les deux retours d'erreurs semblent avoir été éliminés de SUSv2
en faveur d'un retour constant égal à
message.
VOIR AUSSI
catopen(3),
setlocale(3)
TRADUCTION
Ce document est une traduction réalisée par Christophe Blaess
<http://www.blaess.fr/christophe/> le 22 octobre 1996
et révisée le 17 juillet 2008.
L'équipe de traduction a fait le maximum pour réaliser une adaptation
française de qualité. La version anglaise la plus à jour de ce document est
toujours consultable via la commande : « LANG=C man 3 catgets ».
N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute
erreur dans cette page de manuel.
Index
- NOM
-
- SYNOPSIS
-
- DESCRIPTION
-
- VALEUR RENVOYÉE
-
- CONFORMITÉ
-
- NOTES
-
- VOIR AUSSI
-
- TRADUCTION
-
Dernière mise à jour : 17 juillet 2008