CDE

NAME

Set_Locale − 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:

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 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(3)C tt_message_arg_add(3), tt_message_send(3), ttdt_sender_imprint_on(3), ttdt_session_join(3); Get_Locale request.