Man Pages

---

Back to Software Index  Manpage Top Level

Name

Synopsis

#include <nl_types.h>#include <langinfo.h>
char *nl_langinfo(nl_item item);
MT-LevelSafe
with exceptions 
Description nl_langinfo() 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>. 
Since yes and no strings are implemented
using gettext(3I), link with the -lintl library. 
Return ValuesIf 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. 
ExamplesFor 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. 
See Alsogettext(3I), localeconv(3C), setlocale(3C),
strftime(3C), langinfo(5), nl_types(5) WarningsThe array pointed to by
the return value should not be modified by the program.  Subsequent calls
to  nl_langinfo() may overwrite the array. 
This function is built upon the
functions localeconv(), strftime(), and gettext(). Where possible users
are advised to use these interfaces to the required data instead of using
calls to nl_langinfo(). 
Notesnl_langinfo can be used safely in a multi-thread
application, as long as setlocale(3C) is not being called to change the
locale.