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 的末尾(最高)位置

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com