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 indicated locale categories.

The category argument is the locale category to set. A locale category is a group of data types whose output formatting 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. For example, Solaris defines such locales as C, de, fr, it, etc.

ERRORS
The ToolTalk service may return the following error in processing the Set_Locale request:

    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 example:

    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);

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

SEE ALSO
setlocale(3C) Solaris 2.3 Developer's Guide to Internationalization; tt_message_arg_add(3), tt_message_send(3), ttdt_sender_imprint_on(3), ttdt_session_join(3); Get_Locale request.