6.5 Simplified ToASCII Interface

idna_to_ascii_4z

Function: int idna_to_ascii_4z (const uint32_t * input, char ** output, int flags)

input: zero terminated input Unicode string.

output: pointer to newly allocated output string.

flags: an Idna_flags value, e.g., IDNA_ALLOW_UNASSIGNED or IDNA_USE_STD3_ASCII_RULES.

Convert UCS-4 domain name to ASCII string. The domain name may contain several labels, separated by dots. The output buffer must be deallocated by the caller.

Return value: Returns IDNA_SUCCESS on success, or error code.

idna_to_ascii_8z

Function: int idna_to_ascii_8z (const char * input, char ** output, int flags)

input: zero terminated input UTF-8 string.

output: pointer to newly allocated output string.

flags: an Idna_flags value, e.g., IDNA_ALLOW_UNASSIGNED or IDNA_USE_STD3_ASCII_RULES.

Convert UTF-8 domain name to ASCII string. The domain name may contain several labels, separated by dots. The output buffer must be deallocated by the caller.

Return value: Returns IDNA_SUCCESS on success, or error code.

idna_to_ascii_lz

Function: int idna_to_ascii_lz (const char * input, char ** output, int flags)

input: zero terminated input string encoded in the current locale’s character set.

output: pointer to newly allocated output string.

flags: an Idna_flags value, e.g., IDNA_ALLOW_UNASSIGNED or IDNA_USE_STD3_ASCII_RULES.

Convert domain name in the locale’s encoding to ASCII string. The domain name may contain several labels, separated by dots. The output buffer must be deallocated by the caller.

Return value: Returns IDNA_SUCCESS on success, or error code.

This document was generated on February 1, 2012 using texi2html 5.0.