SYNOPSIS

       #include <tld.h>

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

ARGUMENTS

       const char * in
                   Zero-terminated string in the current locales  encoding  to
                   process.

       size_t * errpos
                   Position of offending character is returned here.

       const Tld_table ** overrides
                   A  Tld_table  array of additional domain restriction struc-
                   tures that complement and supersede the  built-in  informa-
                   tion.

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 over-
       rides 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>.

COPYRIGHT

       Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007 Simon Josefsson.
       Permission  is  granted  to make and distribute verbatim copies of this
       manual provided the copyright notice and  this  permission  notice  are
       preserved on all copies.

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.