tld_check_8z(3) 						      libidn							   tld_check_8z(3)

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 addi-
       tional 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 (C) 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.

libidn								       1.28							   tld_check_8z(3)