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]

时间相关

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

Socket API

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

字符串相关

 
 
// 它们对应于标准的 snprintf 和 vsnprintf
int evutil_snprintf(char *buf, size_t buflen, const char *format, ...);
int evutil_vsnprintf(char *buf, size_t buflen, const char *format, va_list ap);

安全的随机数生成

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