Camel.host_idna_to_ascii
Description: Reference for Camel.host_idna_to_ascii

### Function

# Camelhost_idna_to_ascii

since: 3.16

#### Declaration [src]

    gchar*
    camel_host_idna_to_ascii (
      const gchar* host
    )

#### Description [src]

Converts IDN (Internationalized Domain Name) into ASCII representation. If there’s a failure or the `host` has only ASCII letters, then a copy of `host` is returned.

Available since: 3.16

#### Parameters

`host`

  Type: `const gchar*`

  Host name, with or without non-ascii letters in utf8.

  The argument can be `NULL`.
  The data is owned by the caller of the function.
  The value is a NUL terminated UTF-8 string.

#### Return value

Type: `gchar*`

Newly allocated string with only ASCII letters describing the `host` or `NULL`, when the `host` is `NULL`. Free the returned string with `g_free()` when no longer needed.

The caller of the function takes ownership of the data, and is responsible for freeing it.
The return value can be `NULL`.
The value is a NUL terminated UTF-8 string.