DragonFly On-Line Manual Pages

idn_setlocalcheckfile(3)                    DragonFly Library Functions Manual

NAME
       idn_setlocalcheckfile - read local code point set from a file

SYNOPSIS
       #include <idn/api.h>

       idn_result_t
       idn_setlocalcheckfile(const char *file);

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

                              September 21, 2012      idn_setlocalcheckfile(3)