utf8_to_string_target

Converts an UTF-8 string into the best possible representation as a STRING.

The representation of characters not in STRING is not specified; it may be as pseudo-escape sequences \x{ABCD}, or it may be in some other form of approximation.

Parameters:

str	a UTF-8 string

Returns:

the newly-allocated string, or null if the conversion failed. (It should not fail for any properly formed UTF-8 string unless system limits like memory or file descriptors are exceeded.)