函数

GLibVariantnew_take_string

自从：2.38

声明 [源代码]

GVariant*
g_variant_new_take_string (
  gchar* string
)

描述 [源代码]

使用 string 的内容创建一个新的 GVariant 字符串。

string 必须是有效的 UTF-8 字符串，且不能为 NULL。要编码可能为 NULL 的字符串，请与 g_variant_new_maybe() 一起使用。

此调用后，string 属于 GVariant，并且不能再由调用者修改。数据 data 的内存需要动态分配，最终将使用 g_free() 释放。

在传递给此函数后，不应以任何其他方式修改或访问 string。甚至可能立即释放 string。

自从：2.38

此函数对语言绑定不可直接访问。

参数

string

类型： gchar*

一个普通的 UTF-8 空终止字符串。

数据归函数调用者所有。
值是一个空终止的 UTF-8 字符串。

返回值

类型： GVariant

一个指向新字符串 GVariant 实例的浮动的引用。

数据归被调用函数所有。