prg_vector_insert()
摘要
向 vector 中引入一个元素,必要时将所有更高索引的元素向后移动以腾出空间。
语法
prg_vector_insert (vector_ptr, element_ptr, pos_index)
| 参数 | 类型 | 说明 |
|---|---|---|
vector_ptr |
PrgT_Vector * |
目标 vector |
element_ptr |
void * |
要引入到 vector 中的元素 |
pos_index |
unsigned long |
元素在 vector 中的位置(零基索引)。可以是数值,也可以是详情中描述的某个符号常量。 |
返回类型
PrgT_Compcode
指示成功/失败。失败仅因内存资源不足而发生。
头文件
prg_vector.h
详情
与替换元素的 prg_vector_set() 不同,该函数通过将元素向 vector 中更高位置移动来腾出空间,然后将元素引入指定位置。必要时,这种移动可能导致 vector 的内存资源扩展。
位置索引是零基的。也就是说,第一个元素的位置索引为 0,第二个为 1,依此类推。
除了显式的数值之外,pos_index 还可以指定为以下符号常量之一:
PRGC_VECTOR_INSERT_POS_HEAD——将元素插入 vector 的第一个(第 0 个)位置PRGC_VECTOR_INSERT_POS_TAIL——将元素插入 vector 的末尾(最高)位置