utils/event_8h_source.html

 #ifndef EVENT_H_
 #define EVENT_H_

 #include "list.h"

 struct event {
     struct list handlers;
 };

 struct event_handler {
     struct list_element element;
     void (*fun)(struct event *evt, void *ctx);
     struct event *evt;
     unsigned char flags;
 };

 #define EVENT_HANDLER_INIT(handler_fun) {            \
     .element = (struct list_element){ NULL, NULL },  \
     .fun = handler_fun,                              \
     .evt = NULL,                                     \
     .flags = 0                                       \
 }

 int event_handler_init(struct event_handler *handler, void (*fun)(struct event *, void *));

 int event_init(struct event *evt);

 #define EVENT_INIT(event) { .handlers = LIST_INIT((event).handlers) }

 int event_subscribe(struct event *evt, struct event_handler *handler);

 int event_unsubscribe(struct event *evt, struct event_handler *handler);

 int event_publish(struct event *evt, void *ctx);

 #endif /* EVENT_H_ */
event_handler::evt
struct event * evt
pointer to keep track of which event to subscribe to once handler finishes
Definition: event.h:33

event_handler
event handler state
Definition: event.h:23

event
event state
Definition: event.h:15

event_handler_init
int event_handler_init(struct event_handler *handler, void(*fun)(struct event *, void *))
initialize an event handler
Definition: event.c:7

event_unsubscribe
int event_unsubscribe(struct event *evt, struct event_handler *handler)
detach an event_handler from an event
Definition: event.c:36

event::handlers
struct list handlers
a list of event handlers that are subscribed to this event
Definition: event.h:17

list.h
An intrusive circular doubly linked list.

event_init
int event_init(struct event *evt)
initialize a event
Definition: event.c:16

event_subscribe
int event_subscribe(struct event *evt, struct event_handler *handler)
attach an event_handler to an event
Definition: event.c:22

event_handler::fun
void(* fun)(struct event *evt, void *ctx)
handler function pointer
Definition: event.h:30

list_element
list element state
Definition: list.h:15

event_publish
int event_publish(struct event *evt, void *ctx)
publish an event
Definition: event.c:61

event_handler::element
struct list_element element
list element for attaching handler to an event
Definition: event.h:25

list
list state
Definition: list.h:63

event_handler::flags
unsigned char flags
flag used to indicate if the handler should be removed
Definition: event.h:35