函数

GLibucs4_to_utf8

声明 [源]

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

说明 [源]

将字符串从 32 位固定宽度表示形式 UCS-4 转换为 UTF-8。

结果将以一个空字节结尾。

参数

str

类型： gunichar 数组

一个 UCS-4 编码字符串。

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

类型： glong

要使用的 str 的最大长度（字符数）。如果 len 为负，则该字符串以空结尾。

items_read

类型： glong*

存储读取的字符数的位置，或 NULL。

该参数将由函数设置。
该参数可能为 NULL。
items_written

类型： glong*

存储写入的字节数的位置，或 NULL。此处存储的值不包括结尾的空字节。

该参数将由函数设置。
该参数可能为 NULL。
error

类型： GError **

可恢复错误 的返回位置。

该参数可能为 NULL。
如果返回位置不为 NULL，那么您必须将其初始化为 NULL GError*。
如果没有错误，该参数将由函数初始化为 NULL。
如果出错，该参数将设置为新分配的 GError；调用者将拥有该数据的所有权，并负责释放它。

返回值

类型： gchar*

新分配的 UTF-8 字符串的指针。此值必须用 g_free() 释放。如果发生错误，items_read 将设置为第一个无效输入字符的位置。

函数调用者拥有该数据的所有权，并负责释放它。
该值是一个以空结尾的 UTF-8 字符串。