转自: http://name5566.com/4202.html
参考文献列表:
http://www.wangafu.net/~nickm/libevent-book/
此文编写的时候,使用到的 Libevent 为 2.0.21
常用基本数据类型
- evutil_socket_t 用于保存 socket
- ev_uint64_t 取值范围 [0, EV_UINT64_MAX]
- ev_int64_t 取值范围 [EV_INT64_MIN, EV_INT64_MAX]
- ev_uint32_t 取值范围 [0, EV_UINT32_MAX]
- ev_int32_t 取值范围 [EV_INT32_MIN, EV_INT32_MAX]
- ev_uint16_t 取值范围 [0, EV_UINT16_MAX]
- ev_int16_t 取值范围 [EV_INT16_MIN, EV_INT16_MAX]
- ev_uint8_t 取值范围 [0, EV_UINT8_MAX]
- ev_int8_t 取值范围 [EV_INT8_MIN, EV_INT8_MAX]
- 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);