tld

Name

tld -- 

Synopsis



enum        Tld_rc;
int         tld_get_4                       (const uint32_t *in,
                                             size_t inlen,
                                             char **out);
int         tld_get_4z                      (const uint32_t *in,
                                             char **out);
int         tld_get_z                       (const char *in,
                                             char **out);
const Tld_table* tld_get_table              (const char *tld,
                                             const Tld_table **tables);
const Tld_table* tld_default_table          (const char *tld,
                                             const Tld_table **overrides);
int         tld_check_4t                    (const uint32_t *in,
                                             size_t inlen,
                                             size_t *errpos,
                                             const Tld_table *tld);
int         tld_check_4tz                   (const uint32_t *in,
                                             size_t *errpos,
                                             const Tld_table *tld);
int         tld_check_4                     (const uint32_t *in,
                                             size_t inlen,
                                             size_t *errpos,
                                             const Tld_table **overrides);
int         tld_check_4z                    (const uint32_t *in,
                                             size_t *errpos,
                                             const Tld_table **overrides);
int         tld_check_8z                    (const char *in,
                                             size_t *errpos,
                                             const Tld_table **overrides);
int         tld_check_lz                    (const char *in,
                                             size_t *errpos,
                                             const Tld_table **overrides);

Description

Details

enum Tld_rc

  typedef enum
  {
    TLD_SUCCESS = 0,
    TLD_INVALID = 1,		/* Invalid character found. */
    TLD_NODATA = 2,		/* Char, domain or inlen = 0. */
    TLD_MALLOC_ERROR = 3,
    TLD_ICONV_ERROR = 4,
    TLD_NOTLD = 5
  } Tld_rc;

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

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

Error during iconv string conversion.

TLD_NOTLD

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.

in :

Array of unicode code points to process. Does not need to be zero terminated.

inlen :

Number of unicode code points.

out :

Zero terminated ascii result string pointer.

Returns :

Return TLD_SUCCESS on success, the corresponding error code otherwise.


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.

in :

Zero terminated array of unicode code points to process.

out :

Zero terminated ascii result string pointer.

Returns :

Returns TLD_SUCCESS on success, the corresponding error code otherwise.


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.

in :

Zero terminated character array to process.

out :

Zero terminated ascii result string pointer.

Returns :

Returns TLD_SUCCESS on success, the corresponding error code otherwise.


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 :

TLD name (e.g. "com") as zero terminated ASCII byte string.

tables :

Zero terminated array of info-structures for TLDs.

Returns :

Return structure corresponding to TLD tld by going thru tables, or return NULL if no such structure is found.


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 overrided by the (optional) supplied tables.

tld :

TLD name (e.g. "com") as zero terminated ASCII byte string.

overrides :

Additional well-formed info-structures for TLDs, or NULL to only use library deault tables.

Returns :

Return structure corresponding to TLD tld_str, first looking through overrides then thru built-in list, or NULL if no such structure found.


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.

in :

Array of unicode code points to process. Does not need to be zero terminated.

inlen :

Number of unicode code points.

errpos :

Position of offending character is returned here.

tld :

Data structure representing the restrictions for which the input should be tested.

Returns :

Returns TLD_SUCCESS if all code points are valid or when tld is null, TLD_INVALID if a character is not allowed, or additional error codes on general failure conditions.


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.

in :

Zero terminated array of unicode code points to process.

errpos :

Position of offending character is returned here.

tld :

Data structure representing the restrictions for which the input should be tested.

Returns :

Returns TLD_SUCCESS if all code points are valid or when tld is null, TLD_INVALID if a character is not allowed, or additional error codes on general failure conditions.


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.

in :

Array of unicode code points to process. Does not need to be zero terminated.

inlen :

Number of unicode code points.

errpos :

Position of offending character is returned here.

overrides :

An array of additional domain restriction structures that complement and supersede the built-in information.

Returns :

Returns TLD_SUCCESS if all code points are valid or when tld is null, TLD_INVALID if a character is not allowed, or additional error codes on general failure conditions.


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.

in :

Zero-terminated array of unicode code points to process.

errpos :

Position of offending character is returned here.

overrides :

An array of additional domain restriction structures that complement and supersede the built-in information.

Returns :

Returns TLD_SUCCESS if all code points are valid or when tld is null, TLD_INVALID if a character is not allowed, or additional error codes on general failure conditions.


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.

in :

Zero-terminated UTF8 string to process.

errpos :

Position of offending character is returned here.

overrides :

An array of additional domain restriction structures that complement and supersede the built-in information.

Returns :

Returns 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.


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.

in :

Zero-terminated string in the current locales encoding to process.

errpos :

Position of offending character is returned here.

overrides :

An array of additional domain restriction structures that complement and supersede the built-in information.

Returns :

Returns 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.