函数

GLibVariantnew_parsed_va

声明 [源]

GVariant*
g_variant_new_parsed_va (
  const gchar* format,
  va_list* app
)

描述 [源]

解析 format 并返回结果。

这是为从库中使用的 g_variant_new_parsed() 版本。

如果返回值是一个新创建的 GVariant 实例，它将默认为浮点数。在 format 仅指定 GVariant 指针集合的情况下（例如：format 为 “%*”），则收集到的 GVariant 指针将被返回，而不会增加任何附加引用。

请注意，在收集到 #va_list 中的 app 的参数必须与 format 中指定的其类型宽度正确。请参阅 GVariant 实参文档。

为了在所有情况下都能正确行为，调用函数需要在控制权返回给最初提供指针的用户之前，对返回结果调用 g_variant_ref_sink()。此时，调用者将对结果拥有完整的引用。这也可以通过将结果添加到容器中或将其传递给另一个 g_variant_new() 调用来完成。

此函数不可直接供语言绑定时使用。

参数

format

类型： const gchar*

一个文本格式的 GVariant。

数据由函数的调用者拥有。
值是 NUL 结束的 UTF-8 字符串。
app

类型： va_list*

指向 #va_list 的指针。

数据由函数的调用者拥有。

返回值

类型： GVariant

一个新的、通常是浮点数的 GVariant。

调用函数的数据由其所有者承担，并负责释放它。