op_vvec_insert()

摘要

将一个向量的内容插入到另一个已存在的向量中。

语法

op_vvec_insert (target, position, source)
参数 类型 说明
target Vvec_Vector 将源向量元素插入其中的目标值向量
position unsigned int 插入开始的索引号
[向量第一个元素的索引号为 0。]
source Vvec_Vector 其元素将被插入目标值向量的值向量

返回类型

int

完成代码,指示该操作是否成功完成。

可能的返回值列表参见 Table 95 “Value Vector Completion Code Symbolic Constants“ 第 33 页。

示例

/* Create destination vector.	*/
dest = op_vvec_create (OpC_Type_Bit);

for (i = 0; i < strlen (source_string); i++)
	{
	/* Convert a string of characters to a string of bits in a value vector.	*/
	op_vvec_from_value (&temp_vec, OPC_VVEC_BYTE_ORDER_LITTLE_ENDIAN,
		OPC_VVEC_BITFORMAT_ASCII_8, 8, OPC_VVEC_NATIVE_STRING, source_string);

	/* insert this temporary vector into the destination vector.	*/
	/* use OPC_VVEC_VECTOR_END to specify that the values are	*/
	/* appended to the destination vector.				*/
	op_vvec_insert (dest, OPC_VVEC_VECTOR_END, temp_vec);
	}

详情

该过程从指定索引号开始,将一个向量(源向量)的内容复制到目标向量中。如果目标向量中已存在的值的索引号低于 position 参数指定的索引号,则不受影响。索引号等于或大于 position 指定数值的值会被移动到值向量的末尾,但不会被销毁。因此,可以将一个向量插入到另一个向量的中间。两个向量的数据类型必须相同。

例如,如果目标向量为 {1, 2, 3},源向量为 {8,9},那么在位置 1 处将源向量插入目标向量,结果为:{1, 8, 9, 2, 3}。(注意第一个值的索引是 0。)

可以使用符号位置常量来指定将源向量插入目标向量的开头(OPC_VVEC_VECTOR_START)或目标向量的末尾(OPC_VVEC_VECTOR_END)。

源向量不受该过程的影响。

用途

提供一种将一个向量的内容复制到另一个向量而不覆盖目标向量内容的方法。目标向量的原有内容会被移动,为新值腾出空间。

错误

  • 可恢复错误:值向量无效。
  • 可恢复错误:参数值向量中存放的值类型不匹配。
  • 可恢复错误:内存不足,无法执行插入。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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