Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
nl_langinfo(3C)		 Standard C Library Functions	       nl_langinfo(3C)

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 cul-
       tural 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 applica-
       tions,  as  long	 as  setlocale(3C)  is	not being called to change the
       locale.

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe with exceptions	   |
       +-----------------------------+-----------------------------+
       |CSI			     |Enabled			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       setlocale(3C), attributes(5), langinfo(3HEAD), nl_types(3HEAD)

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.

SunOS 5.9			  20 Dec 1996		       nl_langinfo(3C)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | USAGE | ATTRIBUTES | SEE ALSO | WARNINGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=nl_langinfo&sektion=3c&manpath=SunOS+5.9>

home | help