Libevent提供了一些與event相關的操作函式和操作。本文就重點講一下這方面的原始碼。

        在Libevent中，無論是event還是event_base，都是使用指標而不會使用變數。實際上，如果檢視Libevent不同的版本，就可以發現event和event_base這兩個結構體的成員是不同的。對比libevent-2.0.21-stable和libevent-1.4.13-stable這兩個版本，就可以發現其具有相當大的區別。

event的引數:

        一個event結構體和很多東西相關聯，比如event_base、檔案描述符fd、回撥函式、回撥引數等等，下文把這些東西統一稱為引數

1. //event.c檔案
2. evutil_socket_t //監聽的檔案描述符fd
3. event_get_fd(conststruct event *ev)  
4. {  
5.     return ev->ev_fd;  
6. }  
7. struct event_base * //獲取event_base
8. event_get_base(conststruct event *ev)  
9. {  
10.     return
     ev->ev_base;  
11. }  
12. short//獲取該event監聽的事件
13. event_get_events(conststruct event *ev)  
14. {  
15.     return ev->ev_events;  
16. }  
17. event_callback_fn //獲取回撥函式的函式指標
18. event_get_callback(conststruct event *ev)  
19. {  
20.     return ev->ev_callback;  
21. }  
22. void * //獲取回撥函式引數
23. event_get_callback_arg(conststruct
     event *ev)  
24. {  
25.     return ev->ev_arg;  
26. }  
27. void//一個函式獲取所有
28. event_get_assignment(conststruct event *event, struct event_base **base_out, evutil_socket_t *fd_out,   
29.                     short *events_out, event_callback_fn *callback_out, void **arg_out)  
30. {  
31.     if (base_out)  
32.         *base_out = event->ev_base;  
33.     if (fd_out)  
34.         *fd_out = event->ev_fd;  
35.     if (events_out)  
36.         *events_out = event->ev_events;  
37.     if (callback_out)  
38.         *callback_out = event->ev_callback;  
39.     if (arg_out)  
40.         *arg_out = event->ev_arg;  
41. }  

        前面的那些函式是獲取單個引數的，最後那個函式可以同時獲取多個引數。並且如果不想獲取某個引數，可以對應地傳入一個NULL。

event的狀態:

        一個event是可以有多個狀態的，比如已初始化狀態(initialized)、未決狀態(pending)、啟用狀態(active)。

        可以用event_initialized函式檢測一個event是否處於已初始化狀態：

1. //event.c檔案
2. int
3. event_initialized(conststruct event *ev)  
4. {  
5.     if (!(ev->ev_flags & EVLIST_INIT))  
6.         return 0;  
7.     return 1;  
8. }  

        可以看到event_initialized只是檢查event的ev_flags是否有EVLIST_INIT標誌。從之前的博文可以知道，當用戶呼叫event_new後，就會為event加入該標誌，所以用event_new建立的even都是處於已初始化狀態的。

        當用戶呼叫event_new建立一個event後，它還沒處於未決狀態(non-pending)，當用戶呼叫event_add函式，將一個event插入到event_base佇列後，就處於未決狀態(pending)。

        如果event監聽的事件發生了或者超時了，那麼該event就會被啟用，處於啟用狀態。當event的回撥函式被呼叫後，它就不再是啟用狀態了，但還是處於未決狀態。如果使用者呼叫了event_del或者event_free(該函式內部呼叫event_del)，那麼該event就不再是未決狀態了。

1. //event.c檔案
2. int
3. event_pending(conststruct event *ev, short event, struct timeval *tv)  
4. {  
5.     int flags = 0;  
6.     if (EVUTIL_FAILURE_CHECK(ev->ev_base == NULL)) {  
7.         event_warnx("%s: event has no event_base set.", __func__);  
8.         return 0;  
9.     }  
10.     EVBASE_ACQUIRE_LOCK(ev->ev_base, th_base_lock);  
11.     //flags記錄使用者監聽了哪些事件
12.     if (ev->ev_flags & EVLIST_INSERTED)  
13.         flags |= (ev->ev_events & (EV_READ|EV_WRITE|EV_SIGNAL));  
14.     //flags記錄event被什麼事件激活了.使用者可以呼叫event_active
15.     //手動啟用event，並且可以使用之前使用者沒有監聽的事件作為啟用原因
16.     if (ev->ev_flags & EVLIST_ACTIVE)  
17.         flags |= ev->ev_res;  
18.     //記錄該event是否還有超時屬性
19.     if (ev->ev_flags & EVLIST_TIMEOUT)  
20.         flags |= EV_TIMEOUT;  
21.     //event可以被使用者亂設值，然後作為引數。這裡為了保證
22.     //其值只能是下面的事件。
23.     event &= (EV_TIMEOUT|EV_READ|EV_WRITE|EV_SIGNAL);  
24.     /* See if there is a timeout that we should report */
25.     if (tv != NULL && (flags & event & EV_TIMEOUT)) {  
26.         struct timeval tmp = ev->ev_timeout;  
27.         tmp.tv_usec &= MICROSECONDS_MASK;  
28. #if defined(_EVENT_HAVE_CLOCK_GETTIME) && defined(CLOCK_MONOTONIC)
29.         /* correctly remamp to real time */
30.         evutil_timeradd(&ev->ev_base->tv_clock_diff, &tmp, tv);  
31. #else
32.         *tv = tmp;  
33. #endif
34.     }  
35.     EVBASE_RELEASE_LOCK(ev->ev_base, th_base_lock);  
36.     return (flags & event);  
37. }  

        該函式的作用是檢查某個事件(由第二個引數指定)是否處於未決或者啟用狀態。

        由flags的幾個 |= 操作可知，它會把event監聽的事件種類都記錄下來。並且還會把event被啟用的原因(也是一個事件)記錄下來。下面會講到手動啟用一個event。所以event可能會被一個沒有監聽的事件鎖啟用。

        event_pending函式的一個作用是可以判斷一個event是否已經從event_base中刪除了。比如說，某個event監聽寫事件而加入了event_base，但可能在某個時刻被刪除。那麼可以用下面的程式碼判斷這個event是否已經被刪除了。

1. if( event_pending(ev, EV_WRITE, NULL) == 0 )  
2.     printf("delete\n");  
3. else
4.     printf("no delete\n");  

手動啟用event：

        除了執行event_base_dispatch死等外界條件把event啟用外，Libevent還提供了一個API函式event_active，可以手動地把一個event啟用。