函数
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
。