内部和大小计数器

本页将介绍与 Vector 对象实例内部计数器相关的 Vector Helper API

vector_helper_get_count

获取指定 Vector 对象实例中指定类型的计数器值

Syntax

size_t vector_helper_get_count
(
    VectorContext* vector_object_context, 
    VectorCountType count_type
);

Parameters

参数名	类型	必选	描述
vector_object_context	Vector	True	指定 Vector 对象实例描述符
count_type	VectorCountType(Enum)	True	要获取的内部计数器类型

Return Value

类型：size_t

描述：成功返回指定 Vector 对象实例中指定内部计数器的值，失败返回 0。

Remarks

该函数的返回值不可靠，因为被获取的内部计数器的值也有可能为 0，因此不能通过检查返回值是否为 0 作为函数调用成功与否的条件。

vector_helper_get_size

获取指定 Vector 对象实例中指定类型的大小计数器值

Syntax

size_t vector_helper_get_size
(
    VectorContext* vector_object_context, 
    VectorSizeType size_type
);

Parameters

参数名	类型	必选	描述
vector_object_context	Vector	True	指定 Vector 对象实例描述符
size_type	VectorSizeType(Enum)	True	要获取的大小计数器类型

Return Value

类型：size_t

描述：成功返回指定 Vector 对象实例中指定大小计数器的值，失败返回 0。

Remarks

该函数的返回值不可靠，因为被获取的大小计数器的值也有可能为 0，因此不能通过检查返回值是否为 0 作为函数调用成功与否的条件。

vector_helper_get_capacity

获取指定 Vector 对象实例当前可容纳元素的个数

Syntax

size_t vector_helper_get_capacity
(
    VectorContext * vector_object_context
);

Parameters

参数名	类型	必选	描述
vector_object_context	Vector	True	指定 Vector 对象实例描述符

Return Value

类型：size_t

描述：成功返回指定 Vector 对象实例当前可容纳元素的个数，失败返回 0。

Remarks

该函数所返回的当前 Vector 对象实例可容纳元素个数取决于当前内存分配器的运行次数与已分配内存空间的大小（byte）。