idn_nameinit(3)

🎀 NAME 🎀

Okay bestie, meet idn_nameinit(3) — the little setup gremlin from the Library Functions Manual that initializes the libidnkit or libidnkitelite library. (The DESCRIPTION says libidnkitlite; both spellings are in the OG, so I’m not erasing either 💅.)

✨ SYNOPSIS ✨

#include <idn/api.h>

idn_result_t
idn_nameinit(int load_file);

💖 DESCRIPTION 💖

The idn_nameinit() function initializes the libidnkit or libidnkitlite library. Slay.

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 — and yes, check idn2.conf(5) for the deets.

Even if idn_nameinit() is called more than once, the initialization happens only on the first call. Main character energy: one entrance only. 👑

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

When one of these functions is called before idn_nameinit(), initialization will implicitly take place. In that 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) — yes, it’s here twice in the original, so I kept both 💫
• idn2.conf(5)

xoxo, your Library Functions Manual bestie — Sep 21, 2012 · idn_nameinit(3) 💅