tld_check_lz(3) API function


#include <tld.h>

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


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.


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.


Report bugs to <[email protected]>.
General guidelines for reporting bugs:
GNU Libidn home page:


Copyright © 2002-2015 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.