libevent的event_base创建和回收相关接口

1. event_base的创建和回收

1.1 event_base_new

功能：

创建并返回一个新的event_base，event_base是libevent的核心对象，用于保存异步事件循环的相关信息和状态。

备注：

创建的event_base通过event_base_free来回收相关资源。
本函数初始化event_base的时候采用默认参数，如果需要自定义配置参数，则可以通过event_base_new_with_config来进行event_base的创建。

原型：

struct event_base *event_base_new(void);

1.2 event_base_new_with_config

功能：

使用自定义配置参数创建并初始化后，返回一个新的event_base。

备注：

其中event_config通过event_config_new函数创建，并通过event_config_xxx之类的函数进行相关配置设置。

原型：

struct event_base *event_base_new_with_config(
		const struct event_config *cfg);

1.3 event_base_free

功能：

释放event_base相关的所有内存。

备注：

Deallocate all memory associated with an event_base, and free the base.
这个函数不会关闭任何句柄，也不会释放传递给event_new函数作为回调函数的上下文参数的相关内存，如果还有正在pending的finalizer回调函数, 那么这个函数将会调用它。

原型：

void event_base_free(struct event_base *eb);

1.4 event_base_free_nofinalize

功能：

释放event_base相关的所有内存。

备注：

与event_base_free的差别是，它不会调用正在pending的finalizer回调函数。

原型：

void event_base_free_nofinalize(struct event_base *);

1.5 libevent_global_shutdown

功能

释放libevent分配的全局资源。

备注

本函数不释放由开发者控制的资源，譬如event_base, event, bufferevent listener等。它只释放那些libevent管理的诸如全局锁等资源的释放。

在退出前并不一定非要调用本函数的。因为，任何资源在进程退出的时候会自然被释放掉。本函数存在的意义是，当采用资源泄漏工具进行泄漏检测的时候避免在进程退出的时候检测工具报一大堆资源泄漏问题。

原型

void libevent_global_shutdown(void);