idn_setlocalcheckfile(3) | Introduction to Library Functions | idn_setlocalcheckfile(3) |
idn_setlocalcheckfile - read local code point set from a file
#include <idn/api.h> idn_result_t idn_setlocalcheckfile(const char *file);
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.
libidnkit(3), idn_checkname(3), idn_comparenames(3), idn_decodename(3), idn_encodename(3), idn_nameinit(3), idn_result_tostring(3)
September 21, 2012 | OmniOS |