（转）Libevent（3）— 基础库

转自：http://name5566.com/4202.html

参考文献列表：
http://www.wangafu.net/~nickm/libevent-book/

此文编写的时候，使用到的 Libevent 为 2.0.21

常用基本数据类型

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]

时间相关

1. // 用于加或者减前两个参数，结果被保存在第三个参数中
2. #define evutil_timeradd(tvp, uvp, vvp) /* ... */
3. #define evutil_timersub(tvp, uvp, vvp) /* ... */
4. // 清除 timeval 将其值设置为 0
5. #define evutil_timerclear(tvp) /* ... */
6. // 判断 timeval 是否为 0，如果是 0 返回 false，否则返回 true
7. #define evutil_timerisset(tvp) /* ... */
8. // 比较两个 timeval
9. // 使用的时候这样用：
10. // evutil_timercmp(t1, t2, <=) 含义为判断 t1 <= t2 是否成立
11. // cmp 为所有的 C 关系操作符
12. #define evutil_timercmp(tvp, uvp, cmp)
13. // 获取当前时间并保存到 tv
14. // tz 目前无用
15. int evutil_gettimeofday(struct timeval *tv, struct timezone *tz);

Socket API

1. // 用于关闭一个 socket
2. int evutil_closesocket(evutil_socket_t s);
3. #define EVUTIL_CLOSESOCKET(s) evutil_closesocket(s)
4. // 返回当前线程的最后一次 socket 操作的错误码
5. #define EVUTIL_SOCKET_ERROR()
6. // 改变当前 socket 的错误码
7. #define EVUTIL_SET_SOCKET_ERROR(errcode)
8. // 返回特定的 sock 的错误码
9. #define evutil_socket_geterror(sock)
10. // 通过 socket 错误码获取到一个字符串描述
11. #define evutil_socket_error_to_string(errcode)
12. // 设置 sock 为非阻塞的 socket
13. int evutil_make_socket_nonblocking(evutil_socket_t sock);
14. // 设置 sock 的地址可重用
15. int evutil_make_listen_socket_reuseable(evutil_socket_t sock);

字符串相关

1. // 它们对应于标准的 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);

安全的随机数生成

1. // 此函数将使用随机的数据填充 n 个字节的 buf
2. void evutil_secure_rng_get_bytes(void *buf, size_t n);