idn_setlocalencoding(3)idn_setlocalencoding(3)NAMEidn_setlocalencoding - set the local encoding
SYNOPSIS
#include <idn/api.h>
idn_result_t
idn_setlocalencoding(const char *name);
DESCRIPTION
The function sets "the local encoding" to name.
The local encoding value affects results of IDN_UNICODECONV and
IDN_LOCALCONV actions in encoding and decoding conversions.
If name argument is NULL, the local encoding 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 local encoding is
"UTF-8". If an application changes its locale setting, also the local
encoding value is changed automatically.
However, once a non-NULL local encoding name has been set by idn_setlo‐
calencoding(), or set by IDN_LOCAL_CODESET environment variable, the
local encoding will not be changed by locale information any longer.
Upon success, idn_setlocalencoding() returns idn_success. Otherwise,
it returns an error code. See idn_result_tostring(3) for the complete
list of error codes.
SEE ALSOlibidnkit(3), idn_checkname(3), idn_comparenames(3), idn_decodename(3),
idn_encodename(3), idn_nameinit(3), idn_result_tostring(3), idna‐
lias.conf(5)
Sep 21, 2012 idn_setlocalencoding(3)
