DragonFly On-Line Manual Pages

idn_setlanguage(3)    DragonFly Library Functions Manual    idn_setlanguage(3)

NAME
       idn_setlanguage - set the current language

SYNOPSIS
       #include <idn/api.h>

       idn_result_t
       idn_setlanguage(const char *name);

DESCRIPTION
       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.

SEE ALSO
       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            idn_setlanguage(3)