tld_strerror ()

const char *
tld_strerror (Tld_rc rc);

Convert a return code integer to a text string. This string can be used to output a diagnostic message to the user.

TLD_SUCCESS: Successful operation. This value is guaranteed to always be zero, the remaining ones are only guaranteed to hold non-zero values, for logical comparison purposes. TLD_INVALID: Invalid character found. TLD_NODATA: No input data was provided. TLD_MALLOC_ERROR: Error during memory allocation. TLD_ICONV_ERROR: Character encoding conversion error. TLD_NO_TLD: No top-level domain found in domain string.

tld_get_4 ()

int
tld_get_4 (const uint32_t *in,
           size_t inlen,
           char **out);

Isolate the top-level domain of in and return it as an ASCII string in out .

tld_get_4z ()

int
tld_get_4z (const uint32_t *in,
            char **out);

Isolate the top-level domain of in and return it as an ASCII string in out .

tld_get_z ()

int
tld_get_z (const char *in,
           char **out);

Isolate the top-level domain of in and return it as an ASCII string in out . The input string in may be UTF-8, ISO-8859-1 or any ASCII compatible character encoding.

tld_get_table ()

const Tld_table *
tld_get_table (const char *tld,
               const Tld_table **tables);

Get the TLD table for a named TLD by searching through the given TLD table array.

tld_default_table ()

const Tld_table *
tld_default_table (const char *tld,
                   const Tld_table **overrides);

Get the TLD table for a named TLD, using the internal defaults, possibly overridden by the (optional) supplied tables.

tld_check_4t ()

int
tld_check_4t (const uint32_t *in,
              size_t inlen,
              size_t *errpos,
              const Tld_table *tld);

Test each of the code points in in for whether or not they are allowed by the data structure in tld , return the position of the first character for which this is not the case in errpos .

tld_check_4tz ()

int
tld_check_4tz (const uint32_t *in,
               size_t *errpos,
               const Tld_table *tld);

Test each of the code points in in for whether or not they are allowed by the data structure in tld , return the position of the first character for which this is not the case in errpos .

tld_check_4 ()

int
tld_check_4 (const uint32_t *in,
             size_t inlen,
             size_t *errpos,
             const Tld_table **overrides);

Test each of the code points 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 .

tld_check_4z ()

int
tld_check_4z (const uint32_t *in,
              size_t *errpos,
              const Tld_table **overrides);

Test each of the code points 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 .

tld_check_8z ()

int
tld_check_8z (const char *in,
              size_t *errpos,
              const Tld_table **overrides);

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.

tld_check_lz ()

int
tld_check_lz (const char *in,
              size_t *errpos,
              const Tld_table **overrides);

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.

IDNAPI

#define             IDNAPI

Symbol holding shared library API visibility decorator.

This is used internally by the library header file and should never be used or modified by the application.

https://www.gnu.org/software/gnulib/manual/html_node/Exported-Symbols-of-Shared-Libraries.html

struct Tld_table_element

struct Tld_table_element {
    uint32_t start;
    uint32_t end;
};

Interval of valid code points in the TLD.

struct Tld_table

struct Tld_table {
    const char *name;
    const char *version;
    size_t nvalid;
    const Tld_table_element *valid;
};

List valid code points in a TLD.

enum Tld_rc

Enumerated return codes of the TLD checking functions. The value 0 is guaranteed to always correspond to success.