方法

GLibVariantcheck_format_string

自从：2.34

声明 [src]

gboolean
g_variant_check_format_string (
  GVariant* value,
  const gchar* format_string,
  gboolean copy_only
)

描述 [src]

检查是否使用 format_string 在 value 上调用 g_variant_get() 符合类型兼容性。假定 format_string 是一个有效的格式字符串（从语法上看）。

如果 copy_only 是 TRUE，则此函数还检查在调用 g_variant_get() 之后立即调用 g_variant_unref() 在 value 上是否安全，而不会使结果无效。只有在创建深拷贝的情况下（即，在即将释放的 GVariant 实例内部没有指向数据的指针）才能这样做。如果此检查失败，则打印 g_critical() 并返回 FALSE。

此函数旨在由希望提供不确定值的 GVariant 参数的 varargs 访问器函数使用（例如，g_variant_lookup 或 g_menu_model_get_item_attribute）。

自从：2.34

参数

format_string

类型： const gchar*

有效的 GVariant 格式化字符串。

数据属于该方法调用者。

该值是 NUL 结尾的 UTF-8 字符串。

only_copy

类型： gboolean

TRUE 确保格式字符串进行深度复制。

返回值

类型： gboolean

TRUE 如果 format_string 可以安全使用。