GLibutf16_to_ucs4

gunichar*
g_utf16_to_ucs4 (
  const gunichar2* str,
  glong len,
  glong* items_read,
  glong* items_written,
  GError** error
)

Convert a string from UTF-16 to UCS-4. The result will be nul-terminated.

`str`	`const gunichar2*`
	A UTF-16 encoded string.
	The data is owned by the caller of the function.
`len`	`glong`
	The maximum length (number of #gunichar2) of `str` to use. If `len` < 0, then the string is nul-terminated.
`items_read`	`glong*`
	Location to store number of words read, or `NULL`. If `NULL`, then `G_CONVERT_ERROR_PARTIAL_INPUT` will be returned in case `str` contains a trailing partial character. If an error occurs then the index of the invalid input is stored here.
	The argument will be set by the function.
	The argument can be `NULL`.
`items_written`	`glong*`
	Location to store number of characters written, or `NULL`. The value stored here does not include the trailing 0 character.
	The argument will be set by the function.
	The argument can be `NULL`.
`error`	`GError **`
	The return location for a `GError*`, or `NULL`.

Returns:	`gunichar*`
	A pointer to a newly allocated UCS-4 string. This value must be freed with g_free(). If an error occurs, `NULL` will be returned and `error` set.
	The caller of the function takes ownership of the data, and is responsible for freeing it.