Log4gLoggingEvent

Log4gLoggingEvent — The internal representation of logging events

Synopsis

                    Log4gLoggingEvent;
                    Log4gLoggingEventClass;
Log4gLoggingEvent * log4g_logging_event_new             (const gchar *logger,
                                                         Log4gLevel *level,
                                                         const gchar *function,
                                                         const gchar *file,
                                                         const gchar *line,
                                                         const gchar *message,
                                                         va_list ap);
Log4gLevel *        log4g_logging_event_get_level       (Log4gLoggingEvent *self);
const gchar *       log4g_logging_event_get_logger_name (Log4gLoggingEvent *self);
const gchar *       log4g_logging_event_get_rendered_message
                                                        (Log4gLoggingEvent *self);
const gchar *       log4g_logging_event_get_message     (Log4gLoggingEvent *self);
const gchar *       log4g_logging_event_get_mdc         (Log4gLoggingEvent *self,
                                                         const gchar *key);
GTimeVal *          log4g_logging_event_get_time_stamp  (Log4gLoggingEvent *self);
const gchar *       log4g_logging_event_get_thread_name (Log4gLoggingEvent *self);
const gchar *       log4g_logging_event_get_ndc         (Log4gLoggingEvent *self);
const GArray *      log4g_logging_event_get_property_key_set
                                                        (Log4gLoggingEvent *self);
void                log4g_logging_event_get_thread_copy (Log4gLoggingEvent *self);
void                log4g_logging_event_get_mdc_copy    (Log4gLoggingEvent *self);
void                log4g_logging_event_get_ndc_copy    (Log4gLoggingEvent *self);
const gchar *       log4g_logging_event_get_function_name
                                                        (Log4gLoggingEvent *self);
const gchar *       log4g_logging_event_get_file_name   (Log4gLoggingEvent *self);
const gchar *       log4g_logging_event_get_line_number (Log4gLoggingEvent *self);
const gchar *       log4g_logging_event_get_full_info   (Log4gLoggingEvent *self);
glong               log4g_logging_event_get_start_time  (void);
Log4gLevel          (*Log4gLoggingEventGetLevel)        (Log4gLoggingEvent *self);

Description

Once an affirmative decision is made to log an event a logging event instance is created. This instance is passed to appenders and filters to perform actual logging.

Note

This class is only useful to those wishing to extend Log4g.

Details

Log4gLoggingEvent

typedef struct {
} Log4gLoggingEvent;

The Log4gLoggingEvent structure does not have any public members.


Log4gLoggingEventClass

typedef struct {
    Log4gLoggingEventGetLevel get_level;
} Log4gLoggingEventClass;

Log4gLoggingEventGetLevel get_level;

Retrieve the log level of a logging event.

log4g_logging_event_new ()

Log4gLoggingEvent * log4g_logging_event_new             (const gchar *logger,
                                                         Log4gLevel *level,
                                                         const gchar *function,
                                                         const gchar *file,
                                                         const gchar *line,
                                                         const gchar *message,
                                                         va_list ap);

Create a new logging event.

logger :

The name of the logger that is creating this event.

level :

The log level of this event.

function :

The function where this event was logged.

file :

The file where this event was logged.

line :

The line in file where this event was logged.

message :

A printf formatted log message.

ap :

Format parameters.

Returns :

A new logging event object.

Since 0.1


log4g_logging_event_get_level ()

Log4gLevel *        log4g_logging_event_get_level       (Log4gLoggingEvent *self);

Calls the get_level function from the Log4gLoggingEventClass of self.

self :

A logging event object.

Returns :

The log level of self.

Since 0.1


log4g_logging_event_get_logger_name ()

const gchar *       log4g_logging_event_get_logger_name (Log4gLoggingEvent *self);

Retrieve the name of the logger that created a logging event.

self :

A logging event object.

Returns :

The name of the logger that created self.

Since 0.1


log4g_logging_event_get_rendered_message ()

const gchar *       log4g_logging_event_get_rendered_message
                                                        (Log4gLoggingEvent *self);

Retrieve the rendered logging message.

See: log4g_logging_event_get_message()

self :

A logging event object.

Returns :

The rendered logging message.

Since 0.1


log4g_logging_event_get_message ()

const gchar *       log4g_logging_event_get_message     (Log4gLoggingEvent *self);

Retrieve the log message.

This function is equivalent to log4g_logging_event_get_rendered_message().

self :

A logging event object.

Returns :

The log message.

Since 0.1


log4g_logging_event_get_mdc ()

const gchar *       log4g_logging_event_get_mdc         (Log4gLoggingEvent *self,
                                                         const gchar *key);

Retrieve a mapped data context value for a logging event.

See: Log4gMDC

self :

A logging event object.

key :

A mapped data context key.

Returns :

The MDC value for key.

Since 0.1


log4g_logging_event_get_time_stamp ()

GTimeVal *          log4g_logging_event_get_time_stamp  (Log4gLoggingEvent *self);

Retrieve the timestamp of a logging event.

self :

A logging event object.

Returns :

The timestamp of self.

Since 0.1


log4g_logging_event_get_thread_name ()

const gchar *       log4g_logging_event_get_thread_name (Log4gLoggingEvent *self);

Retrieve the name of the thread where a logging event was logged.

self :

A logging event object.

Returns :

The name of the thread where self was logged.

Since 0.1


log4g_logging_event_get_ndc ()

const gchar *       log4g_logging_event_get_ndc         (Log4gLoggingEvent *self);

Retrieve the nested data context for a logging event.

See: Log4gNDC

self :

A logging event object.

Returns :

The rendered NDC string for self.

Since 0.1


log4g_logging_event_get_property_key_set ()

const GArray *      log4g_logging_event_get_property_key_set
                                                        (Log4gLoggingEvent *self);

Get the MDC keys (if any) for this event.

See: Log4gMDC

self :

A logging event object.

Returns :

An array of keys, or NULL if no keys exist.

Since 0.1


log4g_logging_event_get_thread_copy ()

void                log4g_logging_event_get_thread_copy (Log4gLoggingEvent *self);

Copy the current thread name into a logging object.

Asynchronous appenders should call this function.

See: Log4gThreadClass

self :

A logging event object.

log4g_logging_event_get_mdc_copy ()

void                log4g_logging_event_get_mdc_copy    (Log4gLoggingEvent *self);

Copy the current mapped data context into a logging event.

Asynchronous appenders should call this function.

See Log4gMDC

self :

A logging event object.

Since 0.1


log4g_logging_event_get_ndc_copy ()

void                log4g_logging_event_get_ndc_copy    (Log4gLoggingEvent *self);

Copy the current nested data context into a logging event.

Asynchronous appenders should call this function.

See Log4gNDC

self :

A logging event object.

Since 0.1


log4g_logging_event_get_function_name ()

const gchar *       log4g_logging_event_get_function_name
                                                        (Log4gLoggingEvent *self);

Retrieve the function where a logging event was logged.

self :

A logging event object.

Returns :

The function where self was logged.

Since 0.1


log4g_logging_event_get_file_name ()

const gchar *       log4g_logging_event_get_file_name   (Log4gLoggingEvent *self);

Retrieve the file where a logging event was logged.

self :

A logging event object.

Returns :

The file where self was logged.

Since 0.1


log4g_logging_event_get_line_number ()

const gchar *       log4g_logging_event_get_line_number (Log4gLoggingEvent *self);

Retrieve the line number where a logging event was logged.

self :

A logging event object.

Returns :

The line number where self was logged.

Since 0.1


log4g_logging_event_get_full_info ()

const gchar *       log4g_logging_event_get_full_info   (Log4gLoggingEvent *self);

Retrieve the full location information where a logging event was logged.

The full location information is in the format:

function(file:line)

self :

A logging event object.

Returns :

The full log location information for self.

Since 0.1


log4g_logging_event_get_start_time ()

glong               log4g_logging_event_get_start_time  (void);

Retrieve the time when the log system was initialized.

Returns :

The number of seconds elapsed since the Unix epoch when the log system was initialized

Since 0.1


Log4gLoggingEventGetLevel ()

Log4gLevel          (*Log4gLoggingEventGetLevel)        (Log4gLoggingEvent *self);

Retrieve the log level of a logging event.

See: log4g/level.h

self :

A logging event object.

Returns :

The log level of self.

Since 0.1