| idn_setlanguage(3) | Introduction to Library Functions | idn_setlanguage(3) |
idn_setlanguage - set the current language
#include <idn/api.h> idn_result_t idn_setlanguage(const char *name);
The function sets "the current language" to name.
The current language value affects results of "language-local" and "lowercase" mapping procedures in encoding and decoding conversions.
If name argument is NULL, the current language is determined by locale information. For example, the locale category LC_CTYPE has been set to "ja_JP.UTF-8", the idnkit library supposes the current language is "ja" (Japanese). If an application changes its locale setting, also the current language value is changed automatically.
However, once a non-NULL language name has been set by idn_setlanguage() or set by "language" entry in a configuration file, the current language will not be changed by locale information any longer.
Upon success, idn_setlanguage() returns idn_success. Otherwise, it returns an error code. See idn_result_tostring(3) for the complete list of error codes.
libidnkit(3), idn_checkname(3), idn_comparenames(3), idn_decodename(3), idn_encodename(3), idn_nameinit(3), idn_result_tostring(3), idn.conf(5), idnlang.conf(5)
| September 21, 2012 | OmniOS |