GLibucs4_to_utf8

gchar*
g_ucs4_to_utf8 (
  const gunichar* str,
  glong len,
  glong* items_read,
  glong* items_written,
  GError** error
)

Convert a string from a 32-bit fixed width representation as UCS-4. to UTF-8. The result will be terminated with a 0 byte.

`str`	`const gunichar*`
	A UCS-4 encoded string.
	The data is owned by the caller of the function.
`len`	`glong`
	The maximum length (number of characters) of `str` to use. If `len` < 0, then the string is nul-terminated.
`items_read`	`glong*`
	Location to store number of characters read, or `NULL`.
	The argument will be set by the function.
	The argument can be `NULL`.
	The called function takes ownership of the data, and is responsible for freeing it.
`items_written`	`glong*`
	Location to store number of bytes written or `NULL`. The value here stored does not include the trailing 0 byte.
	The argument will be set by the function.
	The argument can be `NULL`.
	The called function takes ownership of the data, and is responsible for freeing it.
`error`	`GError **`
	The return location for a `GError*`, or `NULL`.

Returns:	`utf8`
	A pointer to a newly allocated UTF-8 string. This value must be freed with `g_free()`. If an error occurs, `NULL` will be returned and `error` set. In that case, `items_read` will be set to the position of the first invalid input character.
	The caller of the function takes ownership of the data, and is responsible for freeing it.
	The string is a NUL terminated UTF-8 string.