BEA Logo BEA Tuxedo Release 7.1

  Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy


   Tuxedo Doc Home   |   Reference   |   Topic List   |   Previous   |   Next   |   Contents

   BEA Tuxedo C Function Reference



nl_langinfo() - language information


#include <nl_types.h>
#include <langinfo.h>

char *nl_langinfo (nl_item item);


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.

For example:

nl_langinfo (ABDAY_1);

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

A thread in a multithreaded application may issue a call to nl_langinfo() while running in any context state, including TPINVALIDCONTEXT.


If setlocale() has not been called successfully, or if langinf0() data for a supported language is either not available or 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.


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

See Also

setlocale(3c), strftime(3c), langinfo(5), nl_types(5)