Content-type: text/html Man page of nl_langinfo

nl_langinfo

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

nl_langinfo - Returns language or cultural data defined in the current locale  

LIBRARY

Standard C Library (libc.so, libc.a)  

SYNOPSIS

#include <langinfo.h>

char *nl_langinfo(
        nl_item item);  

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows:

nl_langinfo(): XPG4

Refer to the standards(5) reference page for more information about industry standards and associated tags.  

PARAMETERS

Specifies a constant name or value.  

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 constant names and values that are valid for the item parameter are defined in the langinfo.h header file.
 

EXAMPLES

The following example returns a pointer to the abbreviated name of the first day of the week in the current locale:

nl_langinfo(ABDAY_1)

This function call would return a pointer to the string "Dom" if the identified language was Portuguese, "Sun" if the identified language was English, and so on.  

RETURN VALUES

In a locale where langinfo data is not defined, the nl_langinfo() function returns a pointer to the corresponding string in the POSIX (C) locale. In all locales, the nl_langinfo() function returns a pointer to an empty string if the item parameter contains an invalid setting.  

RELATED INFORMATION

Functions: localeconv(3), setlocale(3), strfmon(3)

Others: i18n_intro(5), l10n_intro(5), standards(5)

Writing Software for the International Market delim off


 

Index

NAME
LIBRARY
SYNOPSIS
STANDARDS
PARAMETERS
DESCRIPTION
EXAMPLES
RETURN VALUES
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:42:00 GMT, October 02, 2010