DragonFly On-Line Manual Pages

idn_nameinit(3)       DragonFly Library Functions Manual       idn_nameinit(3)

NAME
       idn_nameinit - initialize libidnkit or libidnkitelite library

SYNOPSIS
       #include <idn/api.h>

       idn_result_t
       idn_nameinit(int load_file);

DESCRIPTION
       The idn_nameinit() function initializes the libidnkit or libidnkitlite
       library.  If load_file is not 0, it tries to read a default
       configuration file.  If load_file is 0, it assumes no default
       configuration file exists (see idn2.conf(5) for details).

       Even if idn_nameinit() is called more than once, the initialization
       will take place only at the first call.

       Upon success, idn_nameinit() returns idn_success.  Otherwise, it
       returns an error code.  See idn_result_tostring(3) for the complete
       list of error codes.

       When one of the following functions is called prior to idn_nameinit(),
       an initialization will implicitly take place.  In this case,
       idn_nameinit(0) is internally performed as the initialization.

         - idn_encodename()

         - idn_decodename()

         - idn_decodename2()

         - idn_comparenames()

         - idn_comparenames2()

         - idn_checkname()

         - idn_setlocalencoding()

         - idn_setlanguage()

         - idn_setlocalcheckfile()

SEE ALSO
       libidnkit(3), idn_checkname(3), idn_comparenames(3), idn_decodename(3),
       idn_encodename(3), idn_nameinit(3), idn_result_tostring(3),
       idn_setlanguage(3), idn_setlocalencoding(3), idn_setlocalcheckfile(3),
       idn_result_tostring(3), idn2.conf(5)

                              September 21, 2012               idn_nameinit(3)