1tld_check_4(3)                      libidn                      tld_check_4(3)
2
3
4

NAME

6       tld_check_4 - verify that characters are permitted
7

SYNOPSIS

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

ARGUMENTS

15       const uint32_t * in
16                   Array of unicode code points to process. Does not  need  to
17                   be zero terminated.
18
19       size_t inlen
20                   Number of unicode code points.
21
22       size_t * errpos
23                   Position of offending character is returned here.
24
25       const Tld_table ** overrides
26                   A  Tld_table  array of additional domain restriction struc‐
27                   tures that complement and supersede the  built-in  informa‐
28                   tion.
29

DESCRIPTION

31       Test  each of the code points in in for whether or not they are allowed
32       by the information in overrides or  by  the  built-in  TLD  restriction
33       data.  When  data  for the same TLD is available both internally and in
34       overrides, the information in overrides takes  precedence.  If  several
35       entries  for a specific TLD are found, the first one is used.  If over‐
36       rides is NULL, only the built-in information is used.  The position  of
37       the first offending character is returned in errpos.
38

RETURN VALUE

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

REPORTING BUGS

45       Report bugs to <bug-libidn@gnu.org>.
46
48       Copyright © 2002, 2003, 2004, 2005, 2006 Simon Josefsson.
49       Permission  is  granted  to make and distribute verbatim copies of this
50       manual provided the copyright notice and  this  permission  notice  are
51       preserved on all copies.
52

SEE ALSO

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