nl_langinfo(3) Library Functions Manual nl_langinfo(3) NOM nl_langinfo, nl_langinfo_l - Demande d'informations sur la langue et les parametres regionaux BIBLIOTHEQUE Bibliotheque C standard (libc, -lc) SYNOPSIS #include char *nl_langinfo(nl_item item); char *nl_langinfo_l(nl_item item, locale_t locale); Exigences de macros de test de fonctionnalites pour la glibc (consulter feature_test_macros(7)) : nl_langinfo_l() : Depuis la glibc 2.24 : _POSIX_C_SOURCE >= 200809L glibc 2.23 et anterieures : _POSIX_C_SOURCE >= 200112L DESCRIPTION Les fonctions nl_langinfo() et nl_langinfo_l() permettent d'acceder aux parametres regionaux avec plus de souplesse que localeconv(3). nl_langinfo() renvoie une chaine de caracteres correspondant a la valeur de item pour les parametres regionaux globaux courants du programme. nl_langinfo_l() renvoie une chaine de caracteres correspondant a la valeur de item pour les parametres regionaux specifies par l'objet locale, lui-meme cree au prealable a l'aide de newlocale(3). Des elements individuels et additionnels des categories des parametres regionaux peuvent etre demandes. Voici des exemples d'elements de parametres regionaux qui peuvent etre specifies a l'aide de item en utilisant les constantes definies dans : CODESET (LC_CTYPE) Renvoyer une chaine contenant le nom du codage de caracteres utilise dans les parametres regionaux selectionnes, par exemple << UTF-8 >>, << ISO-8859-1 >> ou << ANSI_X3.4-1968 >> (mieux connu sous le nom US-ASCII). Il s'agit de la meme chaine que celle obtenue avec << locale charmap >>. Pour une liste des noms de codage de caracteres, essayez << locale -m >>, cf. locale(1). D_T_FMT (LC_TIME) Renvoyer une chaine qui peut etre utilisee en tant que chaine de format pour strftime(3) afin de representer l'heure et la date de facon specifique aux parametres regionaux (specification de conversion %c). D_FMT (LC_TIME) Renvoyer une chaine qui peut etre utilisee en tant que chaine de format pour strftime(3) afin de representer la date de facon specifique aux parametres regionaux (specification de conversion %x). T_FMT (LC_TIME) Renvoyer une chaine qui peut etre utilisee en tant que chaine de format pour strftime(3) afin de representer l'heure de facon specifique a la localisation (specification de conversion %X). AM_STR (LC_TIME) Renvoyer une chaine qui represente un affixe pour les heures "ante meridiem" (avant midi, "AM") - Utilise dans la specification de conversion %p de strftime(3). PM_STR (LC_TIME) Renvoyer une chaine qui represente un affixe pour les heures "post meridiem" (apres midi, "PM") - utilise dans la specification de conversion %p de strftime(3). T_FMT_AMPM (LC_TIME) Renvoyer une chaine qui peut etre utilisee en tant que chaine de format pour strftime(3) afin de representer une heure selon la notation a.m. ou p.m. de facon specifique aux parametres regionaux (specification de conversion %r). ERA (LC_TIME) Renvoyer la description d'une ere qui contiendra des informations sur la maniere dont les annees sont comptees et affichees pour chaque ere de certains parametres regionaux. Chaque segment de description de l'ere doit etre au format : direction:decalage:date_debut:date_fin:nom_ere:format_ere dont les champs sont decrits ci-dessous : direction Le caractere "+" ou "-". Le caractere "+" signifie que les annees augmentent de date-debut jusqu'a date_fin, alors que le caractere "-" signifie l'oppose. decalage L'annee epoch de date-debut. date_debut Une date au format aaaa/mm/jj ou aaaa, mm et jj correspondent respectivement a l'annee, au mois et au jour du debut de l'ere consideree. date_fin La date de fin de l'ere consideree au meme format que date_debut, ou une des deux valeurs speciales "-*" (moins l'infini) ou "+*" (plus l'infini). nom_ere Le nom de l'ere consideree correspondant a la specification de conversion %EC de strftime(3). format_ere Le format de l'annee de l'ere consideree correspondant a la specification de conversion %EY de strftime(3). Les segments de description d'eres sont separes par des points-virgules. Les parametres regionaux japonais et thai definissent cette valeur, mais la plupart des autres parametres regionaux ne le font pas. ERA_D_T_FMT (LC_TIME) Renvoyer une chaine qui peut etre utilisee en tant que chaine de format pour strftime(3) afin de representer l'heure de facon specifique a la localisation (specification de conversion %Ec). ERA_D_FMT (LC_TIME) Renvoyer une chaine qui peut etre utilisee en tant que chaine de format pour strftime(3) afin de representer l'heure de facon specifique a la localisation. ERA_T_FMT (LC_TIME) Renvoyer une chaine qui peut etre utilisee en tant que chaine de format pour strftime(3) afin de representer l'heure de facon specifique a la localisation. DAY_{1-7} (LC_TIME) Return name of the n-th day of the week. [Warning: this follows the US convention DAY_1 = Sunday, not the international convention (ISO 8601) that Monday is the first day of the week.] (Used in %A strftime(3) conversion specification.) ABDAY_{1-7} (LC_TIME) Renvoyer le nom abrege du n-ieme jour de la semaine (utilise dans la specification de conversion %a de strftime(3)). MON_{1-12} (LC_TIME) Renvoyer le nom du n-ieme mois (utilise dans la specification de conversion %B de strftime(3)) ABMON_{1-12} (LC_TIME) Renvoyer le nom abrege du n-ieme mois (utilise dans la specification de conversion %b de strftime(3)). RADIXCHAR (LC_NUMERIC) Renvoyer le separateur decimal (point, virgule, etc.). THOUSEP (LC_NUMERIC) Renvoyer le caractere separateur pour les milliers (groupe de trois chiffres). YESEXPR (LC_MESSAGES) Renvoyer une expression rationnelle qui peut etre utilisee avec la fonction regex(3) afin de reconnaitre une reponse affirmative a une question de type oui/non. NOEXPR (LC_MESSAGES) Renvoyer une expression rationnelle qui peut etre utilisee avec la fonction regex(3) afin de reconnaitre une reponse negative a une question de type oui/non. CRNCYSTR (LC_MONETARY) Renvoyer le symbole monetaire precede par << - >> si le symbole doit apparaitre avant la valeur, << + >> si le symbole doit apparaitre apres la valeur, ou bien << . >> si le symbole doit remplacer le separateur decimal. La liste ci-dessus ne couvre que quelques exemples des elements qui peuvent etre obtenus. Pour une liste plus detaillee, consultez The GNU C Library Reference Manual. VALEUR RENVOYEE En cas de succes, ces fonctions renvoient un pointeur vers une chaine correspondant a la valeur de item pour les parametres regionaux specifies. Si aucune localisation n'a ete selectionnee par setlocale(3) pour la categorie appropriee, nl_langinfo() renvoie un pointeur vers la chaine correspondante dans la localisation << C >>. C'est aussi vrai pour nl_langinfo_l() si locale specifie des parametres regionaux pour lesquels langinfo n'est pas definie. Si item n'est pas valable, un pointeur vers une chaine vide est renvoye. Le pointeur renvoye par ces fonctions peut referencer des donnees statiques qui peuvent etre ecrasees ; il peut aussi etre rendu non valable par un appel subsequent a nl_langinfo(), nl_langinfo_l() ou setlocale(3). Les memes constatations s'appliquent a nl_langinfo_l() si l'objet definissant les parametres regionaux et reference par locale est desalloue ou modifie par freelocale(3) ou newlocale(3). POSIX stipule que l'application ne doit pas modifier la chaine de caracteres renvoyee par ces fonctions. ATTRIBUTS Pour une explication des termes utilises dans cette section, consulter attributes(7). +--------------------------+--------------------------+----------------+ |Interface | Attribut | Valeur | +--------------------------+--------------------------+----------------+ |nl_langinfo() | Securite des threads | MT-Safe locale | +--------------------------+--------------------------+----------------+ STANDARDS POSIX.1-2008. HISTORIQUE POSIX.1-2001, SUSv2. NOTES Le comportement de nl_langinfo_l() est non defini si locale est l'objet definissant les parametres regionaux special LC_GLOBAL_LOCALE ou n'est pas un objet definissant les parametres regionaux valable. EXEMPLES Le programme suivant definit les parametres regionaux pour le type de caracteres et les valeurs numeriques en fonction de l'environnement et interroge le jeu de caracteres du terminal et le separateur decimal. #include #include #include #include int main(void) { setlocale(LC_CTYPE, ""); setlocale(LC_NUMERIC, ""); printf("%s\n", nl_langinfo(CODESET)); printf("%s\n", nl_langinfo(RADIXCHAR)); exit(EXIT_SUCCESS); } VOIR AUSSI locale(1), localeconv(3), setlocale(3), charsets(7), locale(7) Le manuel de reference de la bibliotheque C GNU TRADUCTION La traduction francaise de cette page de manuel a ete creee par Christophe Blaess , Stephan Rafin , Thierry Vignaud , Francois Micaux, Alain Portal , Jean-Philippe Guerard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas Francois , Florentin Duneau , Simon Paillard , Denis Barbier , David Prevot et Lucien Gentis Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Pages du manuel de Linux 6.06 28 janvier 2024 nl_langinfo(3)