NAME

Get_Locale - get a tool's locale

SYNOPSIS

Get_Locale(in string category,

            out string locale
            [...]);

DESCRIPTION

The Get_Locale request reports the POSIX locale of the indicated locale categories.

The category argument is the locale category to get. 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 current locale of the indicated category. 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 Get_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 Get_Locale request.

Also, Get_Locale can be sent by ttdt_sender_imprint_on(3), with the reply being handled transparently.

SEE ALSO

setlocale(3C) Solaris 2.3 Developer's Guide to Internationalization, ttdt_sender_imprint_on(3), ttdt_session_join(3); Set_Locale request.