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

NAME

6       tld_check_4 - API function
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
39       Return  value:  Returns the Tld_rc value TLD_SUCCESS if all code points
40       are valid or when  tld is null, TLD_INVALID if a character is  not  al‐
41       lowed, or additional error codes on general failure conditions.
42

REPORTING BUGS

44       Report bugs to <help-libidn@gnu.org>.
45       General guidelines for reporting bugs: https://www.gnu.org/gethelp/
46       GNU Libidn home page: https://www.gnu.org/software/libidn/
47
48
50       Copyright © 2002-2022 Simon Josefsson.
51       Copying  and  distribution  of this file, with or without modification,
52       are permitted in any medium without royalty provided the copyright  no‐
53       tice and this notice are preserved.
54

SEE ALSO

56       The  full  documentation  for libidn is maintained as a Texinfo manual.
57       If the info and libidn programs are properly installed  at  your  site,
58       the command
59
60              info libidn
61
62       should  give  you access to the complete manual.  As an alternative you
63       may obtain the manual from:
64
65              https://www.gnu.org/software/libidn/manual/
66
67libidn                               1.41                       tld_check_4(3)
Impressum