tld_check_8z

Section: libidn (3)
Updated: 1.9
Index Return to Main Contents

NAME

tld_check_8z - verify that characters are permitted

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 <bug-libidn@gnu.org>.

COPYRIGHT

Copyright © 2002, 2003, 2004, 2005, 2006, 2007, 2008 Simon Josefsson.
Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.