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(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.