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

Type: 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

Type: 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.