| Top | |
|
|
|
Logging functionalityLogging functionality — Utility functions related to GExiv2's and Exiv2's logging. |
| void | (*GExiv2LogHandler) () |
| GExiv2LogLevel | gexiv2_log_get_level () |
| void | gexiv2_log_set_level () |
| GExiv2LogHandler | gexiv2_log_get_handler () |
| GExiv2LogHandler | gexiv2_log_get_default_handler () |
| void | gexiv2_log_set_handler () |
| void | gexiv2_log_use_glib_logging () |
The functions in this modules can be used to configure the log level of
GExiv2 and Exiv2, in terms of what to log (see gexiv2_log_set_level()) and
how. Either a custom log handler can be used or GLib's logging mechanisms.
void (*GExiv2LogHandler) (GExiv2LogLevel level,const gchar *msg);
The log handler can be set by gexiv2_log_set_handler(). When set, the log handler will receive
all log messages emitted by Exiv2 and gexiv2. It's up to the handler to decide where (and if)
the images are displayed or stored.
void
gexiv2_log_set_level (GExiv2LogLevel level);
Log messages below this level will not be logged.
GExiv2LogHandler
gexiv2_log_get_handler (void);
[skip]
The current GExiv2LogHandler, or the default if none set. See gexiv2_log_get_default_handler.
GExiv2LogHandler
gexiv2_log_get_default_handler (void);
[skip]
The default GExiv2LogHandler, which uses Exiv2's built-in handler. Exiv2 will send the message to stderr.
void
gexiv2_log_set_handler (GExiv2LogHandler handler);
This method is not thread-safe. It's best to set this before beginning to use gexiv2.
[skip]
handler |
A GExiv2LogHandler callback to begin receiving log messages from Exiv2 and gexiv2 |
void
gexiv2_log_use_glib_logging (void);
When called, gexiv2 will install it's own GExiv2LogHandler which redirects all Exiv2 and gexiv2
log messages to GLib's logging calls (g_debug(), g_message(), g_warning(), and g_critical() for the
respective GExiv2LogLevel value). GEXIV2_LOG_LEVEL_MUTE logs are dropped.
One advantage to using this is that GLib's logging control and handlers can be used rather than GExiv2's ad hoc scheme. It also means an application can use GLib logging and have all its messages routed through the same calls.