Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
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 ** over-
     rides);

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  spe-
     cific  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 <help-libidn@gnu.org>.
     General guidelines for reporting bugs: https://www.gnu.org/gethelp/
     GNU Libidn home page: https://www.gnu.org/software/libidn/

COPYRIGHT
     Copyright (C) 2002-2025 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 com-
     mand

	    info libidn

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

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

libidn				      1.43			 tld_check_8z(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=tld_check_8z&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help