Function
GLiblog_writer_default_would_drop
since: 2.68
Declaration [src]
gboolean
g_log_writer_default_would_drop (
GLogLevelFlags log_level,
const char* log_domain
)
Description [src]
Check whether g_log_writer_default()
and g_log_default_handler()
would
ignore a message with the given domain and level.
As with g_log_default_handler()
, this function drops debug and informational
messages unless their log domain (or all
) is listed in the space-separated
G_MESSAGES_DEBUG
environment variable, or DEBUG_INVOCATION=1
is set in
the environment, or by g_log_writer_default_set_debug_domains()
.
This can be used when implementing log writers with the same filtering behaviour as the default, but a different destination or output format:
if (g_log_writer_default_would_drop (log_level, log_domain))
return G_LOG_WRITER_HANDLED;
]|
or to skip an expensive computation if it is only needed for a debugging
message, and `G_MESSAGES_DEBUG` and `DEBUG_INVOCATION` are not set:
```c
if (!g_log_writer_default_would_drop (G_LOG_LEVEL_DEBUG, G_LOG_DOMAIN))
{
g_autofree gchar *result = expensive_computation (my_object);
g_debug ("my_object result: %s", result);
}
Available since: 2.68
Parameters
log_level
-
Type:
GLogLevelFlags
Log level, either from
GLogLevelFlags
, or a user-defined level. log_domain
-
Type:
const char*
Log domain.
The argument can be NULL
.The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string.