tld_check_8z - Man Page

API function


#include <tld.h>

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


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.


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 <>.
General guidelines for reporting bugs:
GNU Libidn home page:

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:


1.41 libidn