内部和大小计数器
本页将介绍与 Vector 对象实例内部计数器相关的 Vector Helper API
获取指定 Vector 对象实例中指定类型的计数器值
size_t vector_helper_get_count
(
VectorContext* vector_object_context,
VectorCountType count_type
);
参数名 | 类型 | 必选 | 描述 |
vector_object_context | Vector | True | 指定 Vector 对象实例描述符 |
count_type | VectorCountType(Enum) | True | 要获取的内部计数器类型 |
类型：
size_t描述：成功返回指定 Vector 对象实例中指定内部计数器的值，失败返回 0。
该函数的返回值不可靠，因为被获取的内部计数器的值也有可能为 0，因此不能通过检查返回值是否为 0 作为函数调用成功与否的条件。
获取指定 Vector 对象实例中指定类型的大小计数器值
size_t vector_helper_get_size
(
VectorContext* vector_object_context,
VectorSizeType size_type
);
参数名 | 类型 | 必选 | 描述 |
vector_object_context | Vector | True | 指定 Vector 对象实例描述符 |
size_type | VectorSizeType(Enum) | True | 要获取的大小计数器类型 |
类型：size_t
描述：成功返回指定 Vector 对象实例中指定大小计数器的值，失败返回 0。
该函数的返回值不可靠，因为被获取的大小计数器的值也有可能为 0，因此不能通过检查返回值是否为 0 作为函数调用成功与否的条件。
获取指定 Vector 对象实例当前可容纳元素的个数
size_t vector_helper_get_capacity
(
VectorContext * vector_object_context
);
参数名 | 类型 | 必选 | 描述 |
vector_object_context | Vector | True | 指定 Vector 对象实例描述符 |
类型：
size_t描述：成功返回指定 Vector 对象实例当前可容纳元素的个数，失败返回 0。
该函数所返回的当前 Vector 对象实例可容纳元素个数取决于当前内存分配器的运行次数与已分配内存空间的大小（byte）。
Last modified 4yr ago