Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

idn_setlocalencoding (3)

Name

idn_setlocalencoding - set the local encoding

Synopsis

#include <idn/api.h>

idn_result_t
idn_setlocalencoding(const char *name);

Description

idn_setlocalencoding(3)    Library Functions Manual    idn_setlocalencoding(3)



NAME
       idn_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.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------------------+
       |ATTRIBUTE TYPE |       ATTRIBUTE VALUE        |
       +---------------+------------------------------+
       |Availability   | library/idnkit/header-idnkit |
       +---------------+------------------------------+
       |Stability      | Committed                    |
       +---------------+------------------------------+
SEE ALSO
       libidnkit(3), idn_checkname(3), idn_comparenames(3), idn_decodename(3),
       idn_encodename(3),   idn_nameinit(3),   idn_result_tostring(3),   idna-
       lias.conf(5)



NOTES
       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source was downloaded from  https://jprs.co.jp/idn/idnkit-2.3.tar.bz2

       Further information about this software can be found on the open source
       community website at https://jprs.co.jp/idn.



                                 Sep 21, 2012          idn_setlocalencoding(3)