GLiblog_set_handler

guint
g_log_set_handler(
constgchar*log_domain,
GLogLevelFlagslog_levels,
GLogFunclog_func,
gpointeruser_data
)

Sets the log handler for a domain and a set of log levels.

To handle fatal and recursive messages the log_levels parameter must be combined with the G_LOG_FLAG_FATAL and G_LOG_FLAG_RECURSION bit flags.

Note that since the G_LOG_LEVEL_ERROR log level is always fatal, if you want to set a handler for this log level you must combine it with G_LOG_FLAG_FATAL.

This has no effect if structured logging is enabled; see Using Structured Logging.

The log_domain parameter can be set to NULL or an empty string to use the default application domain.

Here is an example for adding a log handler for all warning messages in the default domain:

g_log_set_handler(NULL,G_LOG_LEVEL_WARNING|G_LOG_FLAG_FATAL
|G_LOG_FLAG_RECURSION,my_log_handler,NULL);

This example adds a log handler for all critical messages from GTK:

g_log_set_handler("Gtk",G_LOG_LEVEL_CRITICAL|G_LOG_FLAG_FATAL
|G_LOG_FLAG_RECURSION,my_log_handler,NULL);

This example adds a log handler for all messages from GLib:

g_log_set_handler("GLib",G_LOG_LEVEL_MASK|G_LOG_FLAG_FATAL
|G_LOG_FLAG_RECURSION,my_log_handler,NULL);

This function is not directly available to language bindings.

The implementation of this function is provided by g_log_set_handler_full() in language bindings.

log_domain

Type: const gchar*

The log domain application 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.

log_levels

Type: GLogLevelFlags

The log levels to apply the log handler for. To handle fatal and recursive messages as well, combine the log levels with the G_LOG_FLAG_FATAL and G_LOG_FLAG_RECURSION bit flags.

log_func

Type: GLogFunc

The log handler function.

user_data

Type: gpointer

Data passed to the log handler.

The argument can be NULL.

The data is owned by the caller of the function.