Scroll to navigation

appender.h(3) log4c appender.h(3)

NAME

appender.h - Implement this interface for your own strategies for printing log statements.

SYNOPSIS

#include <log4c/defs.h>
#include <log4c/layout.h>
#include <stdio.h>

Data Structures


struct log4c_appender_type
log4c appender type class

Macros


#define log4c_appender_type_define(a_type)

Typedefs


typedef struct __log4c_appender log4c_appender_t
typedef struct log4c_appender_type log4c_appender_type_t
log4c appender type class

Functions


const log4c_appender_type_t * log4c_appender_type_get (const char *a_name)
const log4c_appender_type_t * log4c_appender_type_set (const log4c_appender_type_t *a_type)
log4c_appender_t * log4c_appender_get (const char *a_name)
log4c_appender_t * log4c_appender_new (const char *a_name)
void log4c_appender_delete (log4c_appender_t *a_appender)
const char * log4c_appender_get_name (const log4c_appender_t *a_appender)
const log4c_appender_type_t * log4c_appender_get_type (const log4c_appender_t *a_appender)
const log4c_layout_t * log4c_appender_get_layout (const log4c_appender_t *a_appender)
void * log4c_appender_get_udata (const log4c_appender_t *a_appender)
const log4c_appender_type_t * log4c_appender_set_type (log4c_appender_t *a_appender, const log4c_appender_type_t *a_type)
void * log4c_appender_set_udata (log4c_appender_t *a_appender, void *a_udata)
const log4c_layout_t * log4c_appender_set_layout (log4c_appender_t *a_appender, const log4c_layout_t *a_layout)
int log4c_appender_open (log4c_appender_t *a_appender)
int log4c_appender_append (log4c_appender_t *a_appender, log4c_logging_event_t *a_event)
int log4c_appender_close (log4c_appender_t *a_appender)
void log4c_appender_print (const log4c_appender_t *a_appender, FILE *a_stream)
void log4c_appender_types_free (void)
void log4c_appender_types_print (FILE *fp)

Detailed Description

Implement this interface for your own strategies for printing log statements.

Todo

the appender interface needs a better configuration system depending on the layout type. The udata field is a just a trick.

Macro Definition Documentation

#define log4c_appender_type_define(a_type)

Helper macro to define static appender types.

Parameters

a_type the log4c_appender_type_t object to define

Warning

needs GCC support: otherwise this macro does nothing

Deprecated

This macro, and the static initialialization of appenders in general, is deprecated. Use rather the log4c_appender_type_set() function to initialize your appenders before calling log4c_init()

Typedef Documentation

typedef struct __log4c_appender log4c_appender_t

log4c appender class

typedef struct log4c_appender_type log4c_appender_type_t

log4c appender type class Attributes description:

  • name appender type name
  • open
  • append
  • close

Function Documentation

int log4c_appender_append (log4c_appender_t * this, log4c_logging_event_t * a_event)

log in appender specific way.

Parameters

a_appender the log4c_appender object
a_event the log4c_logging_event_t object to log.

Bug

is this the right place to open an appender ?

References log4c_appender_open(), and log4c_layout_format().

int log4c_appender_close (log4c_appender_t * a_appender)

closes the appender

Parameters

a_appender the log4c_appender_t object

Returns

zero if successful, -1 otherwise

void log4c_appender_delete (log4c_appender_t * a_appender)

Destructor for log4c_appender_t.

References log4c_appender_close().

log4c_appender_t * log4c_appender_get (const char * a_name)

Get a pointer to an existing appender.

Parameters

a_name the name of the appender to return.

Returns

a pointer to an existing appender, or NULL if no appender with the specfied name exists.

References log4c_appender_delete(), log4c_appender_new(), and log4c_appender_print().

const log4c_layout_t * log4c_appender_get_layout (const log4c_appender_t * a_appender)

Parameters

a_appender the log4c_appender_t object

Returns

the appender layout

const char * log4c_appender_get_name (const log4c_appender_t * a_appender)

Parameters

a_appender the log4c_appender_t object

Returns

the appender name

const log4c_appender_type_t * log4c_appender_get_type (const log4c_appender_t * a_appender)

Parameters

a_appender the log4c_appender_t object

Returns

the appender operations

void * log4c_appender_get_udata (const log4c_appender_t * a_appender)

Parameters

a_appender the log4c_appender_t object

Returns

the appender user data

log4c_appender_t * log4c_appender_new (const char * a_name)

Constructor for log4c_appender_t.

References log4c_appender_type_stream, and log4c_layout_get().

int log4c_appender_open (log4c_appender_t * a_appender)

opens the appender.

Parameters

a_appender the log4c_appender_t object

void log4c_appender_print (const log4c_appender_t * a_appender, FILE * a_stream)

prints the appender on a stream

Parameters

a_appender the log4c_appender_t object
a_stream the stream

References log4c_layout_get_name().

const log4c_layout_t * log4c_appender_set_layout (log4c_appender_t * a_appender, const log4c_layout_t * a_layout)

sets the appender layout

Parameters

a_appender the log4c_appender_t object
a_layout the new appender layout

Returns

the previous appender layout

const log4c_appender_type_t * log4c_appender_set_type (log4c_appender_t * a_appender, const log4c_appender_type_t * a_type)

sets the appender type

Parameters

a_appender the log4c_appender_t object
a_type the new appender type

Returns

the previous appender type

void * log4c_appender_set_udata (log4c_appender_t * a_appender, void * a_udata)

sets the appender user data

Parameters

a_appender the log4c_appender_t object
a_udata the new appender user data

Returns

the previous appender user data

const log4c_appender_type_t * log4c_appender_type_get (const char * a_name)

Get a pointer to an existing appender type.

Parameters

a_name the name of the appender type to return.

Returns

a pointer to an existing appender type, or NULL if no appender type with the specified name exists.

const log4c_appender_type_t * log4c_appender_type_set (const log4c_appender_type_t * a_type)

Use this function to register an appender type with log4c. Once this is done you may refer to this type by name both programmatically and in the log4c configuration file.

Parameters

a_type a pointer to the new appender type to set.

Returns

a pointer to the previous appender type of same name.

Example code fragment:

const log4c_appender_type_t log4c_appender_type_s13_file = {


  "s13_file",


  s13_file_open,


  s13_file_append,


  s13_file_close,
};


 


 log4c_appender_type_set(&log4c_appender_type_s13_file);

void log4c_appender_types_free (void)

free all appender types

void log4c_appender_types_print (FILE * fp)

prints all the current registered appender types on a stream

Parameters

fp the stream

Author

Generated automatically by Doxygen for log4c from the source code.

Thu Jan 19 2023 Version 1.2.4