Function

Gdkutf8_to_string_target

Declaration [src]

gchar*
gdk_utf8_to_string_target (
  const gchar* str
)

Description [src]

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`	`const gchar*`
	A UTF-8 string.
	The data is owned by the caller of the function.
	The value is a NUL terminated UTF-8 string.

Return value

Returns:	`gchar*`
	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.)
	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.