eventing.h

Go to the documentation of this file.

#ifndef JABBERWERX_EVENTING_H
#define JABBERWERX_EVENTING_H

#include "util/mem.h"
#include "util/workq.h"


typedef struct _jw_event_dispatch_t jw_event_dispatcher;

typedef struct _jw_event_t jw_event;

typedef struct _jw_event_trigger_t jw_event_trigger_data;

typedef struct _jw_event_data_t
{
    void       *source;
    const char *name;
    jw_event   *notifier;
    void       *data;
    void       *selected;
    jw_pool    *pool;
    bool        handled;
} *jw_event_data;

typedef void (*jw_event_notify_callback)(jw_event_data evt,
                                         void         *arg);

typedef void (*jw_event_result_callback)(jw_event_data evt,
                                         bool          result,
                                         void         *arg);


#ifdef __cplusplus
extern "C"
{
#endif

JABBERWERX_API bool jw_event_dispatcher_create(void                 *source,
                                               jw_workq             *workq,
                                               jw_event_dispatcher **dispatch,
                                               jw_err               *err);

JABBERWERX_API void jw_event_dispatcher_destroy(jw_event_dispatcher *dispatch);

JABBERWERX_API jw_workq *jw_event_dispatcher_get_workq(
        jw_event_dispatcher *dispatch);

JABBERWERX_API jw_event *jw_event_dispatcher_get_event(
        jw_event_dispatcher *dispatch,
        const char          *name);

JABBERWERX_API bool jw_event_dispatcher_create_event(
        jw_event_dispatcher *dispatch,
        const char          *name,
        jw_event           **event,
        jw_err              *err);

JABBERWERX_API const char *jw_event_get_name(jw_event *event);

JABBERWERX_API const void *jw_event_get_source(jw_event *event);

JABBERWERX_API bool jw_event_bind(jw_event                *event,
                                  jw_event_notify_callback cb,
                                  void                    *arg,
                                  jw_err                  *err);

JABBERWERX_API void jw_event_unbind(jw_event                *event,
                                    jw_event_notify_callback cb);

JABBERWERX_API bool jw_event_trigger(jw_event                *event,
                                     void                    *data,
                                     jw_event_result_callback result_cb,
                                     void                    *result_arg,
                                     jw_err                  *err);

JABBERWERX_API void jw_event_trigger_prepared(
        jw_event                *event,
        void                    *data,
        jw_event_result_callback result_cb,
        void                    *result_arg,
        jw_event_trigger_data   *trigger_data);

JABBERWERX_API bool jw_event_prepare_trigger(jw_event_dispatcher *dispatch,
        jw_event_trigger_data **trigger_data, jw_err *err);

JABBERWERX_API void jw_event_unprepare_trigger(
        jw_event_trigger_data *trigger_data);

#ifdef __cplusplus
}
#endif

#endif /* JABBERWERX_EVENTING_H */