nl_langinfo

Name

nl_langinfo - query language and locale information

Library

libc.lib

Synopsis

#include <langinfo.h>

char * nl_langinfo (nl_item item);

Return values

In a locale where langinfo data is not defined, nl_langinfo returns a pointer to the corresponding string in the POSIX locale. In all locales, nl_langinfo returns a pointer to an empty string if item contains an invalid setting. "Dom" if the identified language was Portuguese, and "Sun" if the identified language was English.

Detailed description

The nl_langinfo function returns a pointer to a string containing information relevant to the particular language or cultural area defined in the program’s locale. The manifest constant names and values of item are defined in

#include <langinfo.h>

YESEXPR, NOEXPR, YESSTR, NOSTR items are not supported since LC_MESSAGE category is not supported.

item passed to nl_langinfo can be any value listed below.

CODESET
Name of the character encoding used in the locale.

D_T_FMT
String for formatting date and time

D_FMT Date format string

T_FMT Time format string

T_FMT_AMPM
AM or PM time formatting string

AM_STR
Ante Meridian affix

PM_STR
Post Meridian affix

ABDAY_1 - ABDAY_7
Abbreviated name of the nth day of the week

DAY_1 - DAY_7
Name of the nth day of the week

MON_1 - MON_12
Name of the nth month of the year

ABMON_1 - ABMON_12
Name of the nth month of the year

RADIXCHAR
Radix character i.e character used to separate decimal value

THOUSEP
Separator for thousands

Examples

#include<stdio.h>
#include<locale.h>
#include<langinfo.h>
int main()
{
        //Set the locale to Finnish
        char* locale = setlocale(LC_ALL,"fi_FI.ISO-8859-1");
        char* str = NULL;
        //Check whether locale setting is succesfull or not
        if(NULL != locale)
        {
             printf("Locale setting is successful\n");
             printf("Locale is set to %s\n", locale);
             //Retrieve first day of the week
             str = nl_langinfo(DAY_1);
             if(NULL != str)
             {
                  printf("First day of the week is %s\n", str);
             }
             //Retrieve second month of the year
             str = nl_langinfo(MON_2);
             if(NULL != str)
             {
                  printf("Second month of the year is %s\n", str);
             }
        }
        else
        {
                printf("Locale setting failed\n");
        }
        return 0;
}

Output

Locale setting is successful
Locale is set to fi_FI.ISO-8859-1
First day of the week is sunnuntai
Second month of the year is helmikuu

Feedback

For additional information or queries on this page send feedback