Content-type: text/html Man page of nl_langinfo

nl_langinfo

Section: Standard C Library Functions (3C)
Updated: 24 Jul 2002
Index Return to Main Contents
 

NAME

nl_langinfo - language information  

SYNOPSIS

#include <langinfo.h>

char *nl_langinfo(nl_item item);  

DESCRIPTION

The nl_langinfo() function returns a pointer to a null-terminated string containing information relevant to a particular language or cultural area defined in the programs locale. The manifest constant names and values of item are defined by <langinfo.h>. For example:

nl_langinfo (ABDAY_1);

would return a pointer to the string "Dim" if the identified language was French and a French locale was correctly installed; or "Sun" if the identified language was English.  

RETURN VALUES

If setlocale(3C) has not been called successfully, or if data for a supported language is either not available, or if item is not defined therein, then nl_langinfo() returns a pointer to the corresponding string in the C locale. In all locales, nl_langinfo() returns a pointer to an empty string if item contains an invalid setting.  

USAGE

The nl_langinfo() function can be used safely in multithreaded applications, as long as setlocale(3C) is not being called to change the locale.  

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
CSIEnabled
Interface StabilityStandard
MT-LevelMT-Safe with exceptions

 

SEE ALSO

setlocale(3C), langinfo.h(3HEAD), nl_types.h(3HEAD), attributes(5), standards(5)  

WARNINGS

The array pointed to by the return value should not be modified by the program. Subsequent calls to nl_langinfo() may overwrite the array.


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUES
USAGE
ATTRIBUTES
SEE ALSO
WARNINGS

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