GLibutf16_to_ucs4

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

将一个字符串从 UTF-16 转换为 UCS-4。

结果将以\0 结尾。

str

类型： guint16 数组

用 UTF-16 编码的字符串。

数组的长度在 len 参数中指定。

数据归函数调用者所有。

len

类型： glong

str 要使用元素的最大长度（#gunichar2 的数量）。如果 len 为负数，则字符串以\0 结尾。

items_read

类型： glong*

用于存储已读取的单词数位置，或者 NULL。如果为 NULL，那么如果 str 包含尾部部分字符，则将返回 G_CONVERT_ERROR_PARTIAL_INPUT。如果发生错误，则无效输入的索引将存储在这里。

该参数将由该函数设置。

该参数可以为 NULL。

items_written

类型： glong*

用于存储已写入字符数的位置，或者 NULL。此处存储的值不包括尾部 \0 字符。

该参数将由该函数设置。

该参数可以为 NULL。

error

类型： GError **

可恢复错误的返回位置。

该参数可以为 NULL。

如果返回位置不为 NULL，则必须将其初始化为 NULL GError*。

如果没有错误，该参数将由该函数左初始化为 NULL。

如果发生错误，该参数将被设置为新分配的 GError；调用者拥有数据的归属权，并负责释放它。

类型： gunichar*

新分配的 UCS-4 字符串的指针。此值必须使用 g_free() 释放。

该函数的调用者拥有数据的归属权，并负责释放它。