函数

GLiblog_writer_default

自:2.50

声明 [src]

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

说明 [src]

格式化结构化日志消息并将其输出到平台的默认日志目标。

在 Linux 上,这通常是 systemd 日志,如果从终端运行或输出被重定向到文件,则回退到 stdoutstderr

未来可能会增加对其他特定于平台的日志机制的支持。GLib 的发行者可以修改此函数来强制执行他们自己的(已记录的)特定于平台的日志编写策略。

适合用作 GLogWriterFunc,并且是如果没有使用 g_log_set_writer_func() 设置其他任何内容的默认编写器。

g_log_default_handler() 一样,此函数会忽略调试和信息消息,除非其日志域(或 all)列在以空格分隔的 G_MESSAGES_DEBUG 环境变量中,或者在环境中设置了 DEBUG_INVOCATION=1,或通过 g_log_writer_default_set_debug_domains() 在运行时设置。

g_log_writer_default() 使用 g_log_set_always_fatal() 设置的掩码来确定哪些消息是致命的。当改用自定义编写器函数时,则由编写器函数来确定哪些日志消息是致命的。

自 2.50 起可用

参数

log_level

类型: GLogLevelFlags

日志级别,来自 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