函数

GLibLogWriterFunc

自:2.50

声明

GLogWriterOutput
(* GLogWriterFunc) (
  GLogLevelFlags log_level,
  const GLogField* fields,
  gsize n_fields,
  gpointer user_data
)

描述 [src]

日志条目的写入器函数。日志条目是使用 日志规范中的标准字段名称 的一个或多个 GLogFields 的集合。有关更多信息,请参阅 g_log_structured()

写入器函数必须忽略它们不识别的字段,除非它们可以读取任意二进制输出,因为字段值可能是任意二进制。

log_level 保证包含在 fields 中作为 PRIORITY 字段,但单独提供以便于决定是否或在哪里输出日志条目。

如果写入器函数成功处理日志消息或故意忽略它,则写入器函数应返回 G_LOG_WRITER_HANDLED。如果在处理消息时出现错误(例如,如果写入器函数旨在将消息发送到远程日志服务器以及发生网络错误),则它应返回 G_LOG_WRITER_UNHANDLED。这允许写入器函数链接并回退到更简单的处理程序中(如果失败)。

自 2.50 起可用

参数

log_level

类型: GLogLevelFlags

消息的日志级别。

fields

类型: GLogField 数组

组成消息的字段。

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

类型: gsize

fields 的数量。

user_data

类型: gpointer

传递给 g_log_set_writer_func() 的用户数据。

参数可以是 NULL
数据由函数的调用方所有。

返回值

类型: GLogWriterOutput

如果日志条目已成功处理,则返回 G_LOG_WRITER_HANDLED;否则返回 G_LOG_WRITER_UNHANDLED