NAME

       tld_check_8z - API function

SYNOPSIS

       #include <tld.h>

       int tld_check_8z(const char * in, size_t * errpos, const Tld_table ** overrides);

ARGUMENTS

       const char * in
                   Zero-terminated UTF8 string to process.

       size_t * errpos
                   Position of offending character is returned here.

       const Tld_table ** overrides
                   A  Tld_table  array of additional domain restriction structures that complement and supersede
                   the built-in information.

DESCRIPTION

       Test each of the characters in  in for whether or not they are allowed by the information  in   overrides
       or  by  the built-in TLD restriction data. When data for the same TLD is available both internally and in
       overrides , the information in  overrides takes precedence. If several entries for  a  specific  TLD  are
       found,  the  first  one  is  used.   If   overrides  is NULL, only the built-in information is used.  The
       position of the first offending character is returned in  errpos .  Note that the error  position  refers
       to the decoded character offset rather than the byte position in the string.

       Return  value:  Returns  the  Tld_rc  value TLD_SUCCESS if all characters are valid or when  tld is null,
       TLD_INVALID if a character is not allowed, or additional error codes on general failure conditions.

REPORTING BUGS

       Report bugs to <bug-libidn@gnu.org>.
       General guidelines for reporting bugs: http://www.gnu.org/gethelp/
       GNU Libidn home page: http://www.gnu.org/software/libidn/

COPYRIGHT

       Copyright © 2002-2016 Simon Josefsson.
       Copying and distribution of this file, with or without modification, are permitted in any medium  without
       royalty provided the copyright notice and this notice are preserved.

SEE ALSO

       The full documentation for libidn is maintained as a Texinfo manual.  If the info and libidn programs are
       properly installed at your site, the command

              info libidn

       should give you access to the complete manual.  As an alternative you may obtain the manual from:

              http://www.gnu.org/software/libidn/manual/