Sortix main manual

This manual documents Sortix main. You can instead view this document in the latest official manual.

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 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 <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

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.