event_new

 

truct event *event_new(struct event_base *, evutil_socket_t, short, event_callback_fn, void *);

分配并初始化一个新的event结构体，准备被添加。

该函数返回一个新的event，可以被用来event_add或者event_del。Fd和events参数决定了哪些情况会触发事件；callback和callback_arg告诉libevent，当事件触发的时候该干什么。

如果事件包含EV_READ,EV_WRITE,或者他们的组合，那么fd这个文件描述符或者socket将要被监视什么时候可读，什么时候可写。如果事件包含EV_SIGNAL，那么fd就是需要等待事件的号码。如果事件不包含上面的任何标志，那么该事件只能被一个超时触发或者被event_active()手动的激活：这种情况，fd必须是-1。

EV_PERSIST标志也可以被传递给事件参数：它让event_add变永久的直到调用event_del删除该事件。

EV_ET标志和EV_READ,EV_WRITE兼容，不过只能被特定的平台支持。它告诉Libevent使用边沿触发的事件。

EV_TIMEOUT在这没有任何作用。

多个事件在同一个fd上监听是没问题的；但是它们要么全是边沿触发，要么都不是边沿触发的。

当event被激活，事件循环会执行提供的回调函数，用三个参数。第一个是fd，第二个是触发的事件的bit值：EV_READ, EV_WRITE, or EV_SIGNAL.这里EV_TIMEOUT标志表示一个超时触发了，然后EV_ET表示一个边沿触发的事件发生了。第三个参数是callback_arg。

参数1：base表示event base。

参数2：fd，文件描述符或者socket，或者-1

参数3：events，需要监控的事件：EV_READ, EV_WRITE,

      EV_SIGNAL, EV_PERSIST, EV_ET的位域。

参数4：callback，回调函数

参数5：callback_arg， 回调函数的参数

返回值：一个新分配的时间被创建，需要用event_free释放。