内部和大小计数器
本页将介绍与 Vector 对象实例内部计数器相关的 Vector Helper API
vector_helper_get_count
获取指定 Vector 对象实例中指定类型的计数器值
Syntax
1
size_t vector_helper_get_count
2
(
3
VectorContext* vector_object_context,
4
VectorCountType count_type
5
);
Copied!
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
1
size_t vector_helper_get_size
2
(
3
VectorContext* vector_object_context,
4
VectorSizeType size_type
5
);
Copied!
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
1
size_t vector_helper_get_capacity
2
(
3
VectorContext * vector_object_context
4
);
Copied!
Parameters
参数名
类型
必选
描述
vector_object_context
Vector
True
指定 Vector 对象实例描述符
Return Value
类型：
size_t描述：成功返回指定 Vector 对象实例当前可容纳元素的个数，失败返回 0。
Remarks
该函数所返回的当前 Vector 对象实例可容纳元素个数取决于当前内存分配器的运行次数与已分配内存空间的大小（byte）。
Last modified 3yr ago