idn_checkname(3)

🌸 NAME 🌸

okay bestie, so this whole page is idn_checkname(3), straight from the Library Functions Manual — and it's literally the function that validates an internationalized domain name. it's giving “is this domain name valid or not, bestie?” energy 💅✨

✨ SYNOPSIS ✨

#include <idn/api.h>

idn_result_t
idn_checkname(idn_action_t actions, const char *from);

💖 DESCRIPTION 💖

so idn_checkname() lowkey does the thing: internally it creates a copy of name, encodes that copy with idn_encodename(), and returns its error code. periodt. 🫶

and on top of the action macros for idn_encodename() — like IDN_UNICODECONV — the following macros are available just for idn_checkname():

• IDN_CHECK_REGIST — encodes a domain name with the IDNA2008 registration protocol to validate a domain name. currently, its value is the same as IDN_ENCODE_REGIST. 👑
• IDN_CHECK_LOOKUP — encodes a domain name with the IDNA2008 lookup protocol to validate a domain name. currently, its value is the same as IDN_ENCODE_LOOKUP. 🦋

🎀 EXAMPLES 🎀

the program below is literally an example of idn_checkname() in action:

idn_result_t r;
...
r = idn_checkname(IDN_CHECK_REGIST, name);
if (r == idn_success)
    fprintf(stderr, "'%s' is valid\n", name);
else {
    fprintf(stderr, "'%s' is not valid: %s\n",
         name, idn_result_tostring(r));
}
...

🌈 SEE ALSO 🌈

go check out these icons too, bestie:

• idncheck(1)
• libidnkit(3)
• idn_encodename(3)
• idn_nameinit(3)
• idn_result_tostring(3)
• idn.conf(5)

xoxo, bestie 💋 — that was idn_checkname(3) from the Library Functions Manual, dated Sep 21, 2012. mwah, slay, bye ✨💖