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