轉(zhuǎn)自：http://name5566.com/4202.html

?

參考文獻(xiàn)列表：
http://www.wangafu.net/~nickm/libevent-book/

此文編寫的時(shí)候，使用到的 Libevent 為 2.0.21

常用基本數(shù)據(jù)類型

1. evutil_socket_t 用于保存 socket
2. ev_uint64_t 取值范圍 [0, EV_UINT64_MAX]
3. ev_int64_t 取值范圍 [EV_INT64_MIN, EV_INT64_MAX]
4. ev_uint32_t 取值范圍 [0, EV_UINT32_MAX]
5. ev_int32_t 取值范圍 [EV_INT32_MIN, EV_INT32_MAX]
6. ev_uint16_t 取值范圍 [0, EV_UINT16_MAX]
7. ev_int16_t 取值范圍 [EV_INT16_MIN, EV_INT16_MAX]
8. ev_uint8_t 取值范圍 [0, EV_UINT8_MAX]
9. ev_int8_t 取值范圍 [EV_INT8_MIN, EV_INT8_MAX]
10. ev_ssize_type（signed size_t）取值范圍 [EV_SSIZE_MIN, EV_SSIZE_MAX]

時(shí)間相關(guān)

1. // 用于加或者減前兩個(gè)參數(shù)，結(jié)果被保存在第三個(gè)參數(shù)中
2. #define evutil_timeradd ( tvp , uvp , vvp ) /* ... */
3. #define evutil_timersub ( tvp , uvp , vvp ) /* ... */
4. ?
5. // 清除 timeval 將其值設(shè)置為 0
6. #define evutil_timerclear ( tvp ) /* ... */
7. // 判斷 timeval 是否為 0，如果是 0 返回 false，否則返回 true
8. #define evutil_timerisset ( tvp ) /* ... */
9. ?
10. // 比較兩個(gè) timeval
11. // 使用的時(shí)候這樣用：
12. // evutil_timercmp(t1, t2, <=) 含義為判斷 t1 <= t2 是否成立
13. // cmp 為所有的 C 關(guān)系操作符
14. #define evutil_timercmp ( tvp , uvp , cmp )
15. ?
16. // 獲取當(dāng)前時(shí)間并保存到 tv
17. // tz 目前無(wú)用
18. int evutil_gettimeofday ( struct timeval * tv , struct timezone * tz );

Socket API

1. // 用于關(guān)閉一個(gè) socket
2. int evutil_closesocket ( evutil_socket_t s );
3. #define EVUTIL_CLOSESOCKET ( s ) evutil_closesocket ( s )
4. ?
5. // 返回當(dāng)前線程的最后一次 socket 操作的錯(cuò)誤碼
6. #define EVUTIL_SOCKET_ERROR ()
7. // 改變當(dāng)前 socket 的錯(cuò)誤碼
8. #define EVUTIL_SET_SOCKET_ERROR ( errcode )
9. // 返回特定的 sock 的錯(cuò)誤碼
10. #define evutil_socket_geterror ( sock )
11. // 通過(guò) socket 錯(cuò)誤碼獲取到一個(gè)字符串描述
12. #define evutil_socket_error_to_string ( errcode )
13. ?
14. // 設(shè)置 sock 為非阻塞的 socket
15. int evutil_make_socket_nonblocking ( evutil_socket_t sock );
16. ?
17. // 設(shè)置 sock 的地址可重用
18. int evutil_make_listen_socket_reuseable ( evutil_socket_t sock );

字符串相關(guān)

1. // 它們對(duì)應(yīng)于標(biāo)準(zhǔn)的 snprintf 和 vsnprintf
2. int evutil_snprintf ( char * buf , size_t buflen , const char * format , ...);
3. int evutil_vsnprintf ( char * buf , size_t buflen , const char * format , va_list ap );

安全的隨機(jī)數(shù)生成

1. // 此函數(shù)將使用隨機(jī)的數(shù)據(jù)填充 n 個(gè)字節(jié)的 buf
2. void evutil_secure_rng_get_bytes ( void * buf , size_t n );

Libevent（3）— 基礎(chǔ)庫(kù)