idn_setlocalcheckfile(3)

🎀 NAME 🎀

hiii bestie 💖 this is idn_setlocalcheckfile(3) from the Library Functions Manual, and it’s literally the page for read local code point set from a file. The function is idn_setlocalcheckfile, and its whole job is pulling a local code point set out of a file. slay. 💅

✨ SYNOPSIS ✨

#include <idn/api.h>

idn_result_t
idn_setlocalcheckfile(const char *file);

💖 DESCRIPTION 💖

okay so the function idn_setlocalcheckfile() reads local code point set from file. Upon success, it returns idn_success. Otherwise, it returns an error code. See idn_result_tostring(3) for the complete list of error codes. 🫶

The local code point set file is a simple text file, consisting of lines (other than comment lines, which begin with #, and empty lines) of the form:

code-point

or:

start-code-point..end-code-point

where code-point, start-code-point, and end-code-point are hexadecimal Unicode code point values. Here is an example:

002E
0030..0039
0061..007A

Setting the local code point set by calling idn_setlocalcheckfile(), an optional "local check" will be performed in encoding and decoding conversions if IDN_LOCALCHECK action is designated. 👑

The local check searches an internationalized domain name to be converted for a code point not listed in the code point file. If found, the encoding or decoding function returns an error code idn_localcheck_error. 😭

Specifying file argument to NULL, the local code point set is cleared. In an encoding or decoding conversion, no code point check is performed even when IDN_LOCALCHECK action is designated. 🫶

🌈 SEE ALSO 🌈

• libidnkit(3)
• idn_checkname(3)
• idn_comparenames(3)
• idn_decodename(3)
• idn_encodename(3)
• idn_nameinit(3)
• idn_result_tostring(3)

okay bye bestie 🫶 — this Library Functions Manual page is stamped Sep 21, 2012, and the footer title is idn_setlocalcheckfile(3). mwah 💋✨