DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

IntlLocal(TCL_ADM)


IntlLocal, IntlLocalizeMsg -- localize message

Syntax

IntlLocalizeMsg messageId [argList]
IntlLocal type messageId [argList]

Description

These functions provide the support for fully internationalizing Tcl applications using symbolic message ids and external message catalogs. Both return properly localized data.

IntlLocal
localize the specified message and optionally format arguments into the message as with sprintf. This is equivalent to a IntlLocal command with the text option. With the ``type'' argument, IntlLocal can return a Tcl list structure rather than just the localized text.

IntlLocalizeMsg
localize the specified message and optionally format arguments into the message as with sprintf(S).

Arguments


messageId
the symbolic message ID. It must be in the form XXXX_MSG_YYYY or XXXX_ERR_YYYY. It is used to index the external message catalog or the default message set defined locally in the application itself.

argList
a list of arguments to format into the message. There must be corresponding sprintf format specifications in the message catalog string. Use of the %n$ form is encouraged fot multiple format specifiers.

type
the type of localized message format returned: "text" - Return the message as a localized text string only "ext" - Return the message in the external, Tcl list format:

{msgId moduleIdNum msgNum msgText}

Notes

If the Tcl message declaration file for the module ID has not been sourced, it will be loaded from the a Tcl library.

See also

gencat(CP),
16 September 2002
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003