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>.      GNU      Libidn      home      page:
       http://www.gnu.org/software/libidn/      General      help     using     GNU     software:
       http://www.gnu.org/gethelp/

COPYRIGHT

       Copyright © 2002-2013 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.