Initializing help system before first use

XNLSsetlang

XNLSsetlang


Purpose
Set or get the active language for message translation.
Synopsis
const char *XNLSsetlang(const char *lang);
Argument
lang 
An ISO 639 language code ( e.g. en, de, ja, zh...), or NULL or an empty string ""
Return value
The new language code.
Further information
1. The language code is used to select the locale directory in which catalog files are searched from. During the library initialisation the language is set according to the current system settings.
2. If NULL is used as the language code the function returns the current language. If an empty string is given then the language is set to the system default setting (as after library initialisation).
3. Special language names "C", "POSIX" as well as "en" disable translation (since initial messages are written in English).
4. All loaded message catalogs are unloaded when a call to this routine modifies the current language.
Related topics