Declaration [src]

const char*
soup_tld_get_base_domain (
  const char* hostname,
  GError** error

Description [src]

Finds the base domain for a given hostname

The base domain is composed by the top level domain (such as .org, .com,, etc) plus the second level domain, for example for it will return

Note that NULL will be returned for private URLs (those not ending with any well known TLD) because choosing a base domain for them would be totally arbitrary.

Prior to libsoup 2.46, this function required that hostname be in UTF-8 if it was an IDN. From 2.46 on, the name can be in either UTF-8 or ASCII format (and the return value will be in the same format).


hostname const char*

A hostname.

 The data is owned by the caller of the function.
 The value is a NUL terminated UTF-8 string.
error GError **
  The return location for a GError*, or NULL.

Return value

Returns: const char*

A pointer to the start of the base domain in hostname. If an error occurs, NULL will be returned and error set.

 The data is owned by the called function.
 The value is a NUL terminated UTF-8 string.