libevent 笔记
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 );
完