> Linux Reviews > man >

catgets

Obtenir un message contenu dans un catalogue.


  1. catgets.3.man


1. catgets.3.man

Manpage of CATGETS

CATGETS

Section: Manuel du programmeur Linux (3)
Updated: 9 août 1998
Index Return to Main Contents
 

NOM

catgets - Obtenir un message contenu dans un catalogue.  

SYNOPSIS

#include <nl_types.h>

char *catgets (nlcatd catalog, int set_number , int message_number, 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 qui doit avoir été 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 une zone de 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.  

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 de message.  

CONFORMITÉ

POSIX.1-2001.  

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 14 août 2006.

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
NOTES
CONFORMITÉ
VOIR AUSSI
TRADUCTION

This document was created by man2html using the manual pages.
Time: 17:36:33 GMT, October 23, 2013

SVENSKA - SVENSKA - ja - pl