idn_nameinit(3) Introduction to Library Functions idn_nameinit(3)

idn_nameinit - initialize libidnkit or libidnkitelite library

#include <idn/api.h>
idn_result_t
idn_nameinit(int load_file);

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()

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 OmniOS