g_hostname_to_ascii ()

gchar *
g_hostname_to_ascii (const gchar *hostname);

Converts hostname to its canonical ASCII form; an ASCII-only string containing no uppercase letters and not ending with a trailing dot.

Since: 2.22

g_hostname_to_unicode ()

gchar *
g_hostname_to_unicode (const gchar *hostname);

Converts hostname to its canonical presentation form; a UTF-8 string in Unicode normalization form C, containing no uppercase letters, no forbidden characters, and no ASCII-encoded segments, and not ending with a trailing dot.

Of course if hostname is not an internationalized hostname, then the canonical presentation form will be entirely ASCII.

Since: 2.22

g_hostname_is_non_ascii ()

gboolean
g_hostname_is_non_ascii (const gchar *hostname);

Tests if hostname contains Unicode characters. If this returns TRUE, you need to encode the hostname with g_hostname_to_ascii() before using it in non-IDN-aware contexts.

Note that a hostname might contain a mix of encoded and unencoded segments, and so it is possible for g_hostname_is_non_ascii() and g_hostname_is_ascii_encoded() to both return TRUE for a name.

Since: 2.22

g_hostname_is_ascii_encoded ()

gboolean
g_hostname_is_ascii_encoded (const gchar *hostname);

Tests if hostname contains segments with an ASCII-compatible encoding of an Internationalized Domain Name. If this returns TRUE, you should decode the hostname with g_hostname_to_unicode() before displaying it to the user.

Note that a hostname might contain a mix of encoded and unencoded segments, and so it is possible for g_hostname_is_non_ascii() and g_hostname_is_ascii_encoded() to both return TRUE for a name.

Since: 2.22

g_hostname_is_ip_address ()

gboolean
g_hostname_is_ip_address (const gchar *hostname);

Tests if hostname is the string form of an IPv4 or IPv6 address. (Eg, "192.168.0.1".)

Since 2.66, IPv6 addresses with a zone-id are accepted (RFC6874).

Since: 2.22