函数

GLiblog_variant

自版本：2.50 起

声明 [src]

void
g_log_variant (
  const gchar* log_domain,
  GLogLevelFlags log_level,
  GVariant* fields
)

说明 [src]

日志中包含结构化数据的消息，接受 GVariant 中的数据。

此版本特别适用于其他语言，通过内省来使用。

fields 词典中唯一强制的项目为 "MESSAGE"，该项目必须包含向用户展示的文本。

fields 词典中的值可能是 G_VARIANT_TYPE_STRING 类型。还支持字节数组 (G_VARIANT_TYPE_BYTESTRING)，在这种情况下，消息将作为二进制文件进行处理，并将作为此类消息转发给日志作者。数组大小不应高于 G_MAXSSIZE，否则它将被截断为该大小。对于其他类型，g_variant_print() 将用于将值转换为字符串。

有关其用法和参数的更多详细信息，请参阅 g_log_structured()。

自版本 2.50 起可用

参数

log_domain

类型： const gchar*

日志域，通常为 G_LOG_DOMAIN。

参数可以为 NULL。

数据归函数调用者所有。

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

log_level

类型： GLogLevelFlags

日志级别，来自 GLogLevelFlags 或者用户自定义的级别。

fields

类型： GVariant

一个字典（GVariant，类型为 G_VARIANT_TYPE_VARDICT），包含消息数据的键值对。

数据归函数调用者所有。