struct event_base* event_init(void): 使用前必做的一件事,初始化事件API。

void event_set(struct event *ev, int fd, short event, void (*fn)(int, short, void *),void *arg);

初始化一个事件 ev.

fd 表示文件描述符。

event 关注的事件类型.可用‘|’类型组合。


  • EV_TIMEOUT-时间通知
  • EV_SIGNAL-信号通知
  • EV_READ-可读通知
  • EV_WRITE-可写通知
  • EV_PERSIST-额外的标记,表示添加为永久事件,直到调用event_del

fn 函数指针,当事件到达时调用此函数。函数形式必须为void fn(int fd,short event,void *arg)

   其中,fd为当前处理的文件描述符号,event 事件类型,arg 参数指针。

   注:所有参数都将由事件系统自动传入。

arg 为参数指针,和fn中arg对应。

int event_add(struct event *ev, struct timeval *tv);

将事件ev添加入事件系统,等待超时为tv,如果没有时间限制,则设为NULL

成功返回0,否则返回-1且出错原因设置到erron

int event_del(struct event *ev); 从事件系统删除ev,如果事件不存在,或者已被执行,则无效

成功返回0,否则返回-1且出错原因设置到erron

int event_pending(struct event *ev, short event, struct timeval *tv):判断ev的event事件是否正在处理。

int event_initialized(struct event *ev):定义的一个宏,判断ev是否被初始化。

事件优先级:

int event_priority_init(int npriorities):

使用优先级机制首先应做的事,事件优先级初始化,必须在第一个event_dispatch前被调用。

int event_priority_set(struct event *ev, int priority):默认的都是中优先级,调用此函数显示设置ev优先级。

int event_dispatch(void):调用此函数,循环接受事件处理,仅仅出错时才返回。

线程安全相关:

libevent不能同一个event_base被多个线程使用,唯一的方法是每个线程拥有自己的event_base,通过pipe来进行通讯。

并因该如下做:

//初始化event

struct event_base* mEventBase = (struct event_base*)event_init();

//创建一个event(事件)

struct event* mEvAccept = (struct event*)malloc( sizeof( struct event ) );

event_set( mEvAccept, listenFD, EV_READ|EV_PERSIST,

     SP_EventCallback::onAccept, mAcceptArg );

//添加事件到mEventBase 

event_base_set( mEventBase, mEvAccept );

event_add( mEvAccept, NULL );

//处理mEventBase 中的事件,在处理的时候,只允许该处理线程对mEventBase 添加和删除event。

//因而设计时可以先创建一个pipe读事件并加入到mEventBase 。如有其他线程想把fd事件加入mEventBase时,只需向pipe写入建好的fd事件指针。

//然后交给pipe EV_READ的触发函数处理。

event_base_dispatch( mEventBase );