函数
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 日志,如果从终端运行或输出被重定向到文件,则回退到 stdout
或 stderr
。
未来可能会增加对其他特定于平台的日志机制的支持。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
。