快速创建与销毁 Vector 对象实例

如何使用 Vector Helper？

Vector Helper 模块的所有函数与数据类型均声明在 vector_helper.h 标头文件中，您只需要在您项目中需要使用 Vector Helper 模块的代码文件中包含 vector_helper.h 即可。

C/C++
#include "vector_helper.h"

什么是 Vector 对象实例？

每个 Vector Array 均被抽象描述为 Vector 对象实例，而每个 Vector 对象实例均由 Vector 类型所表示，而使用该类型定义的变量均为指针，被抽象描述为 Vector 对象实例描述符，该类型被定义在 vector_helper.h 中。

C
typedef struct _VectorContext
{
	size_t current_element_count;
	size_t last_reserved_element_count;
	size_t max_element_count;
	size_t current_alloc_count;
	size_t current_alloc_memory_size;
	size_t single_element_size;
	void** element;
} VectorContext, *Vector;

在您使用 Vector Helper API 时，均需要提供 Vector 对象实例描述符。

如何创建与销毁 Vector 对象实例？

您可以通过调用 Vector Helper API 来快速创建一个 Vector 对象实例：

C
Vector vector_object = vector_helper_create_object(sizeof(int), 1, 99);

通过上述代码，我们快速创建了一个 Vector 对象实例，并得到了该 Vector 对象实例的描述符，它包含一个 Vector Int 数组。单个元素大小为 sizeof(int)，初始预留 1 个元素大小的容量，最多允许存放 99 个元素。当然，若您不希望设置最大元素个数，可以将最后一个参数设置为 VECTOR_NO_MAX_ELEMENT 宏。

现在我们尝试销毁它：

C
if(vector_object)
{
    vector_helper_destroy_object(vector_object);
    vector_object = NULL;
}

现在，我们已销毁了由 vector_helper_create_object 创建的 Vector 对象实例和描述符。

​