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

FreeBSD Manual Pages

  
 
  

home | help
NL_LANGINFO(3)	       FreeBSD 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 contains 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.

FreeBSD	Ports 11.2		 July 30, 2012		    FreeBSD Ports 11.2

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | EXAMPLES | SEE ALSO | STANDARDS | HISTORY

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=nl_langinfo&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help