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 **
       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	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  al-
       lowed, 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  no-
       tice 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.	 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+14.3.quarterly>

home | help