_O_n_l_i_n_e _M_a_n_u_a_l		Library	Functions	     setlocale(3)



NNNNAAAAMMMMEEEE
     setlocale - modify	and query a program's locale

SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
     ####iiiinnnncccclllluuuuddddeeee <<<<llllooooccccaaaalllleeee....hhhh>>>>

     cccchhhhaaaarrrr ****sssseeeettttllllooooccccaaaalllleeee((((ccccaaaatttteeeeggggoooorrrryyyy,,,, llllooooccccaaaalllleeee))))
     iiiinnnntttt ccccaaaatttteeeeggggoooorrrryyyy;;;;
     cccchhhhaaaarrrr ****llllooooccccaaaalllleeee;;;;

DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     _s_e_t_l_o_c_a_l_e selects the appropriate piece of	the program's
     locale as specified by the	_c_a_t_e_g_o_r_y and _l_o_c_a_l_e arguments.
     The _c_a_t_e_g_o_r_y argument may have the	following values (these
     names are defined in the <<<<llllooooccccaaaalllleeee....hhhh>>>> header	file):

     LC_CTYPE	    affects the	behavior of the	character han-
		    dling functions (_i_s_d_i_g_i_t, _t_o_l_o_w_e_r, etc.) and
		    the	multibyte character functions (such as
		    _m_b_t_o_w_c and _w_c_t_o_m_b).

     LC_NUMERIC	    affects the	decimal-point character	for the
		    formatted input/output functions and the
		    string conversion functions	as well	as the
		    non-monetary formatting information	returned
		    by _l_o_c_a_l_e_c_o_n_v.

     LC_TIME	    affects the	behavior of _a_s_c_f_t_i_m_e, _c_f_t_i_m_e,
		    _g_e_t_d_a_t_e and	_s_t_r_f_t_i_m_e.

     LC_COLLATE	    affects the	behavior of _s_t_r_c_o_l_l and	_s_t_r_x_f_r_m.

     LC_MONETARY    affects the	monetary formatted information
		    returned by	_l_o_c_a_l_e_c_o_n_v.

     LC_MESSAGES    affects the	behavior of _g_e_t_t_x_t, _c_a_t_o_p_e_n, _c_a_t_-
		    _c_l_o_s_e, and _c_a_t_g_e_t_s.

     LC_ALL	    names the program's	entire locale.

     Each category corresponds to a set	of databases which con-
     tain the relevant information for each defined locale.  The
     location of a database is given by	the following path,
     ////uuuussssrrrr////lllliiiibbbb////llllooooccccaaaalllleeee////_l_o_c_a_l_e/_c_a_t_e_g_o_r_y, where _l_o_c_a_l_e and _c_a_t_e_g_o_r_y
     are the names of locale and category, respectively.  For
     example, the database for the LC_CTYPE category for the
     "german" locale would be found in
     ////uuuussssrrrr////lllliiiibbbb////llllooooccccaaaalllleeee////ggggeeeerrrrmmmmaaaannnn////LLLLCCCC____CCCCTTTTYYYYPPPPEEEE.

     A value of	"C" for	_l_o_c_a_l_e specifies the default environment.

     A value of	"" for _l_o_c_a_l_e specifies	that the locale	should be
     taken from	environment variables.	The order in which the
     environment variables are checked for the various categories
     is	given below:

	  Category	 1st Env. Var.	 2nd Env. Var
	  ___________________________________________
	  LC_CTYPE:	 LC_CTYPE	 LANG






	  LC_COLLATE:	 LC_COLLATE	 LANG
	  LC_TIME:	 LC_TIME	 LANG
	  LC_NUMERIC:	 LC_NUMERIC	 LANG
	  LC_MONETARY:	 LC_MONETARY	 LANG
	  LC_MESSAGES:	 LC_MESSAGES	 LANG

     At	program	startup, the equivalent	of

	  setlocale(LC_ALL, "C")

     is	executed.  This	has the	effect of initializing each
     category to the locale described by the environment "C".

     If	a pointer to a string is given for _l_o_c_a_l_e, _s_e_t_l_o_c_a_l_e
     attempts to set the locale	for the	given category to _l_o_c_a_l_e.
     If	_s_e_t_l_o_c_a_l_e succeeds, _l_o_c_a_l_e is returned.	 If _s_e_t_l_o_c_a_l_e
     fails, a null pointer is returned and the program's locale
     is	not changed.

     For category LC_ALL, the behavior is slightly different.  If
     a pointer to a string is given for	_l_o_c_a_l_e and LC_ALL is
     given for _c_a_t_e_g_o_r_y, _s_e_t_l_o_c_a_l_e attempts to set the locale for
     all the categories	to _l_o_c_a_l_e.  The	_l_o_c_a_l_e may be a	simple
     locale, consisting	of a single locale, or a composite
     locale.  A	composite locale is a string beginning with a "/"
     followed by the locale of each category separated by a "/".
     If	_s_e_t_l_o_c_a_l_e fails	to set the locale for any category, a
     null pointer is returned and the program's	locale for all
     categories	is not changed.	 Otherwise, locale is returned.

     A null pointer for	_l_o_c_a_l_e causes _s_e_t_l_o_c_a_l_e	to return the
     current locale associated with the	_c_a_t_e_g_o_r_y.  The program's
     locale is not changed.

FFFFIIIILLLLEEEESSSS
     /usr/lib/locale/C/LC_CTYPE	 - LC_CTYPE database for the C
     locale.
     /usr/lib/locale/C/LC_NUMERIC		- LC_NUMERIC
     database for the C	locale.
     /usr/lib/locale/C/LC_TIME	 - LC_TIME database for	the C
     locale.
     /usr/lib/locale/C/LC_COLLATE		- LC_COLLATE
     database for the C	locale.
     /usr/lib/locale/C/LC_MESSAGES		- LC_MESSAGES
     database for the C	locale.
     /usr/lib/locale/_l_o_c_a_l_e/_c_a_t_e_g_o_r_y		- files	contain-
     ing the locale specific information for each locale and
     category.

SSSSEEEEEEEE AAAALLLLSSSSOOOO
     Library Functions (3):
			 ctime,	ctype, getdate,	gettxt,
			 localeconv, mbtowc, printf, strcoll,
			 strftime, strtod, strxfrm, wctomb

December 1990				TX Programmer's	Reference