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)