Function
Camelutils_sanitize_ascii_domain_in_address
since: 3.44
Declaration [src]
gchar*
camel_utils_sanitize_ascii_domain_in_address (
const gchar* email_address,
gboolean do_format
)
Description [src]
Checks whether the domain in the email_address requires
conversion to ASCII and if it does it also converts it.
When the do_format is TRUE, the output string is formatted
for display, otherwise it’s encoded for use in the message
headers. A NULL is returned when no conversion was needed.
Available since: 3.44
Parameters
email_address-
Type:
const gchar*An email address as string.
The argument can be NULL.The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. do_format-
Type:
gbooleanWhat format will be returned.
Return value
Type: gchar*
The email_address with only ASCII letters,
if such conversion is needed or NULL, when no conversion was required.
See: camel_hostname_utils_requires_ascii(), camel_internet_address_sanitize_ascii_domain(), camel_utils_sanitize_ascii_domain_in_url_str().
| 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. |