1tld_check_8z(3)                     libidn                     tld_check_8z(3)
2
3
4

NAME

6       tld_check_8z - API function
7

SYNOPSIS

9       #include <tld.h>
10
11       int  tld_check_8z(const  char * in, size_t * errpos, const Tld_table **
12       overrides);
13

ARGUMENTS

15       const char * in
16                   Zero-terminated UTF8 string to process.
17
18       size_t * errpos
19                   Position of offending character is returned here.
20
21       const Tld_table ** overrides
22                   A Tld_table array of additional domain  restriction  struc‐
23                   tures  that  complement and supersede the built-in informa‐
24                   tion.
25

DESCRIPTION

27       Test each of the characters in in for whether or not they  are  allowed
28       by  the  information  in  overrides  or by the built-in TLD restriction
29       data. When data for the same TLD is available both  internally  and  in
30       overrides,  the  information  in overrides takes precedence. If several
31       entries for a specific TLD are found, the first one is used.  If  over‐
32       rides  is NULL, only the built-in information is used.  The position of
33       the first offending character is returned in  errpos.   Note  that  the
34       error  position  refers to the decoded character offset rather than the
35       byte position in the string.
36

RETURN VALUE

38       Returns the Tld_rc value TLD_SUCCESS if all  characters  are  valid  or
39       when  tld  is null, TLD_INVALID if a character is not allowed, or addi‐
40       tional error codes on general failure conditions.
41

REPORTING BUGS

43       Report  bugs  to   <bug-libidn@gnu.org>.    GNU   Libidn   home   page:
44       http://www.gnu.org/software/libidn/  General  help  using GNU software:
45       http://www.gnu.org/gethelp/
46

48       Copyright © 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010  Simon
49       Josefsson.
50       Copying  and  distribution  of this file, with or without modification,
51       are permitted in any medium  without  royalty  provided  the  copyright
52       notice and this notice are preserved.
53

SEE ALSO

55       The  full  documentation  for libidn is maintained as a Texinfo manual.
56       If the info and libidn programs are properly installed  at  your  site,
57       the command
58
59              info libidn
60
61       should give you access to the complete manual.
62
63
64
65libidn                               1.18                      tld_check_8z(3)
Impressum