Man Linux: Main Page and Category List

NAME

       tld_check_lz - API function

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
                   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, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 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.