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
newlocale(3)	       FreeBSD Library Functions Manual		  newlocale(3)

NAME
     newlocale -- Creates a new	locale

LIBRARY
     Standard C	Library	(libc, -lc)

SYNOPSIS
     #include <xlocale>

     newlocale(int mask, const char * locale, locale_t base);

DESCRIPTION
     Creates a new locale, inheriting some properties from an existing locale.
     The mask defines the components that the new locale will have set to the
     locale with the name specified in the locale parameter.  Any other	compo-
     nents will	be inherited from base.	 The mask is either LC_ALL_MASK, indi-
     cating all	possible locale	components, or the logical OR of some combina-
     tion of the following:

	   LC_COLLATE_MASK   The locale	for string collation routines.	This
			     controls alphabetic ordering in strcoll(3)
			      and strxfrm(3).

	   LC_CTYPE_MASK     The locale	for the	ctype(3) and multibyte(3)
			     functions.	 This controls recognition of upper
			     and lower case, alphabetic	or non-alphabetic
			     characters, and so	on.

	   LC_MESSAGES_MASK  Set a locale for message catalogs,	see catopen(3)
			     function.

	   LC_MONETARY_MASK  Set a locale for formatting monetary values; this
			     affects the localeconv(3) function.

	   LC_NUMERIC_MASK   Set a locale for formatting numbers.  This	con-
			     trols the formatting of decimal points in input
			     and output	of floating point numbers in functions
			     such as printf(3) and scanf(3), as	well as	values
			     returned by localeconv(3).

	   LC_TIME_MASK	     Set a locale for formatting dates and times using
			     the strftime(3) function.

     This function uses	the same rules for loading locale components as
     setlocale(3).

RETURN VALUES
     Returns a new, valid, locale_t or NULL if an error	occurs.	 You must free
     the returned locale with freelocale(3).

SEE ALSO
     duplocale(3), freelocale(3), localeconv(3), querylocale(3), uselocale(3),
     xlocale(3)

STANDARDS
     This function, conforms to	IEEE Std 1003.1-2008 (``POSIX.1'')

FreeBSD	9.3		       September 17 2011		   FreeBSD 9.3

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

Want to link to this manual page? Use this URL:
<http://www.freebsd.org/cgi/man.cgi?query=newlocale&sektion=3&manpath=FreeBSD+9.1-RELEASE>

home | help