函数

GLiblog_writer_format_fields

自 2.50 起

声明 [src]

gchar*
g_log_writer_format_fields (
  GLogLevelFlags log_level,
  const GLogField* fields,
  gsize n_fields,
  gboolean use_color
)

描述 [src]

将结构化日志消息格式化为适合输出到终端（或其他地方）的字符串。

这将包括它知道如何解释的所有字段的值，其中包括 MESSAGE 和 GLIB_DOMAIN（请参阅 g_log_structured() 的文档）。不包括未知字段的值。

返回的字符串没有拖尾换行符。它使用当前区域设置的字符集进行编码，但不一定是 UTF-8。

自 2.50 起提供

参数

log_level

类型： GLogLevelFlags

日志级别，取自 GLogLevelFlags 或用户自定义级别。

fields

类型： 一个 GLogField 数组

形成日志消息的结构化数据的键值对。

数组的长度在 n_fields 参数中指定。
数据归函数的调用者所有。
n_fields

类型： gsize

fields 数组中的元素数。

use_color

类型： gboolean

格式化消息时 TRUE 表示使用 ANSI 颜色转义序列，FALSE 表示不使用。

返回值

类型： gchar*

包含格式化日志消息的字符串，使用当前区域设置的字符集编码。

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