nl_langinfo(3) [freebsd man page]

NL_LANGINFO(3)						   BSD Library Functions Manual 					    NL_LANGINFO(3)

NAME

     nl_langinfo -- language information

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <langinfo.h>

     char *
     nl_langinfo(nl_item item);

     char *
     nl_langinfo_l(nl_item item, locale_t loc);

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 or thread's locale, or in the case of nl_langinfo_l(), the locale passed as the second argument.  The manifest constant names
     and values of item are defined in <langinfo.h>.

     Calls to setlocale() with a category corresponding to the category of item, or to the category LC_ALL, may overwrite the buffer pointed to by
     the return value.

RETURN VALUES

     In a locale where langinfo data is not defined, nl_langinfo() returns a pointer to the corresponding string in the POSIX locale.
     nl_langinfo_l() returns the same values as nl_langinfo().	In all locales, nl_langinfo() returns a pointer to an empty string if item con-
     tains an invalid setting.

EXAMPLES

     For example:

	   nl_langinfo(ABDAY_1)

     would return a pointer to the string "Dom" if the identified language was Portuguese, and "Sun" if the identified language was English.

SEE ALSO

     setlocale(3)

STANDARDS

     The nl_langinfo() function conforms to Version 2 of the Single UNIX Specification (``SUSv2'').  The nl_langinfo_l() function conforms to IEEE
     Std 1003.1-2008 (``POSIX.1'').

HISTORY

     The nl_langinfo() function first appeared in FreeBSD 4.6.

BSD
								   July 30, 2012							       BSD

nl_langinfo(3)						     Library Functions Manual						    nl_langinfo(3)

NAME

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

LIBRARY

       Standard C Library (libc)

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(): XSH5.0

       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.

       The  array  pointed to by the return value may contain static data that is overridden on the next call to nl_langinfo().  This array should
       not be modified by the application, only by further calls to nl_langinfo().

       The XSH specification does not require the nl_langinfo() function to be re-entrant.

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

																    nl_langinfo(3)