函数

GLibucs4_to_utf16

声明 [src]

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

说明 [src]

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

转换后的文本之后将添加一个空字符 (U+0000)。

参数

str

类型: gunichar 数组

UCS-4 编码的字符串。

数组长度在 len 参数中指定。
数据归函数调用者所有。
len

类型: glong

要使用的 str 的最大长度(字符数)。如果 len 为负数,则字符串以空结尾。

items_read

类型: glong*

用于储存读取的字节数的位置,或 NULL。如果发生错误,则在此储存无效输入的索引。

此参数将由函数设置。
参数可以是 NULL
items_written

类型: glong*

用于储存写入的 gunichar2 数的位置,或 NULL。此储存的值不包括尾部空值。

此参数将由函数设置。
参数可以是 NULL
error

类型: GError **

用于储存 可恢复错误 的返回位置。

参数可以是 NULL
如果返回位置不是 NULL,那么您必须将其初始化为 NULL GError*
如果没有错误,此参数将由函数初始化并保留为 NULL
如果发生错误,此参数将设置为一个新分配的 GError;调用者将拥有该数据的归属权,并负责释放它。

返回值

类型: gunichar2*

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

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