DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

Set_Locale(4)




Set_Locale(4)	 DEVICES AND NETWORK INTERFACES	    Set_Locale(4)

NAME
     Set_Locale	request	- set a	tool's locale

SYNOPSIS
     Set_Locale(in string category,
		in string locale
		[...]);

DESCRIPTION
     The Set_Locale request reports the	POSIX locale of	the indi-
     cated locale categories.

     The category argument is the  locale  category  to	 set.	A
     locale  category  is a group of data types	whose output for-
     matting varies according to locale	in a similar way.  ISO	C
     and  locale categories are:

	  LC_ALL
	  LC_COLLATE
	  LC_CTYPE
	  LC_MESSAGES
	  LC_MONETARY
	  LC_NUMERIC
	  LC_TIME

     The locale	argument is the	name of	the  locale  to	 set  the
     indicated	 category   to.	   The	 value	 of   locale   is
     implementation-defined.

ERRORS
     The ToolTalk service may return the following error in  pro-
     cessing the Set_Locale request:

	TT_DESKTOP_EINVAL
	      The locale argument is not valid on  the	handler's
	      host.

APPLICATION USAGE
     The ttdt_session_join(3), function	can be used  to	 register
     for, and transparently process, the Set_Locale request.

EXAMPLES
     The Set_Locale request can	be sent	as in the following exam-
     ple:

	  Tt_message msg = tttk_message_create(0, TT_REQUEST, TT_SESSION,
		      the_recipient_procid, TTDT_SET_LOCALE,
		      my_callback);
	  tt_message_arg_add(msg, TT_IN, Tttk_string, "LC_MONETARY");
	  tt_message_arg_add(msg, TT_IN, Tttk_string, "de");
	  tt_message_send(msg);

Unix System LaboratorLast change: 13 May 1994			1

Set_Locale(4)	 DEVICES AND NETWORK INTERFACES	    Set_Locale(4)

WARNINGS
     Set_Locale	can also be sent as a  multicast  notice,  as  an
     edict  to all tools in the	scope of the message.  The conse-
     quences of	doing so can be	severe and unexpected.

SEE ALSO
     setlocale(3C) tt_message_arg_add(3), tt_message_send(3),
     ttdt_sender_imprint_on(3),	ttdt_session_join(3); Get_Locale
     request.

Unix System LaboratorLast change: 13 May 1994			2


Man(1) output converted with man2html