Vector Helper
BlogGithub
Search…
Vector Helper
简介
构建
安装与卸载
清理
常见问题
学习使用 Vector Helper
快速创建与销毁 Vector 对象实例
尝试 Push & Remove 元素
尝试 Set & Get 元素
尝试 Reserve & Handover 元素
尝试 Push Multiple 和 Pop 元素
尝试获取 Size & Count 和 Capacity
尝试 Quick Enum 元素
Vector Helper API
Vector 对象实例生命周期
内部和大小计数器
元素存取与管理
元素预订与撤销
元素快速枚举器
内存管理
数据结构和枚举器
Powered By GitBook
内部和大小计数器
本页将介绍与 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）。
​
Vector Helper API - Previous
Vector 对象实例生命周期
Next - Vector Helper API
元素存取与管理
Last modified 3yr ago
Copy link
Outline
vector_helper_get_count
vector_helper_get_size
vector_helper_get_capacity