prg_vector_append_unique()
摘要
向 vector 末尾添加一个元素,但仅当该元素尚不存在时才添加。
语法
prg_vector_append_unique (vector_ptr, element_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
vector_ptr |
PrgT_Vector * |
目标 vector |
element_ptr |
void * |
要添加到 vector 末尾的元素 |
返回类型
PrgT_Compcode
指示插入成功,或因元素已存在而失败(也可能因新元素的内存资源不足而失败)
头文件
prg_vector.h
详情
行为与 prg_vector_append() 相同,但会先验证该元素是否已存在。相同元素是否存在,仅通过比较元素的内存地址来判断,而不是通过任何复杂的等价性判定。如果该元素已经存在于 vector 中,则此调用不产生任何效果,并返回失败代码。