GLibucs4_to_utf16

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

Convert a string from UCS-4 to UTF-16. A 0 character will be added to the result after the converted text.

`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 bytes read, or `NULL`. 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`.
	The called function takes ownership of the data, and is responsible for freeing it.
`items_written`	`glong*`
	Location to store number of #gunichar2 written, or `NULL`. The value stored here does not include the trailing 0.
	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:	`gunichar2*`
	A pointer to a newly allocated UTF-16 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.