op_vvec_remove()

摘要

从已存在的向量中移除数据元素,并返回一个包含这些元素的新向量。

语法

op_vvec_remove (source, position, count)
参数 类型 说明
source Vvec_Vector 将从中移除元素的值向量
[该向量必须是已存在的向量。该向量中的值将被移除并放入一个新的值向量,该新向量即为本过程的返回值。]
position unsigned int 要从源向量中移除的第一个元素的索引号
count unsigned int 要移除的元素数量

返回类型

Vvec_Vector

由从源向量中移除的元素组成的值向量。

示例

/* apply 16-bit chunks of a bit value vector on an esys interface. */
for (i = 0; i < (op_vvec_size_get (src_vector) / 16); i++)
	{
	head = op_vvec_remove (vvec, OPC_VVEC_VECTOR_START, 16);

	/* Schedule values on the esys vector interface at 100 ns intervals. */
	op_esys_interface_vector_set (intf_id, op_sim_time() + (i * 1e-7), head, 0);

	/* done with this value vector. */
	op_vvec_destroy (head);
	}

/* source vector's data has been send to the esys interface. */
op_vvec_destroy (src_vector);

详情

该过程允许你从一个向量中移除特定元素,并创建一个仅包含这些元素的新向量。源向量会同时失去被移除的值及其索引位置。因此,源向量的大小加上新向量的大小等于原始源向量的大小。

例如,若对向量 {1, 2, 3, 4, 5} 应用 op_vvec_remove(),position 参数为 1,count 为 2,则得到以下向量:

Original vector: {1, 4, 5}
New vector:      {2, 3}

(注意向量中第一个位置的索引为 0。)

新的值向量是 op_vvec_remove() 的返回值。可以移除源向量的所有值,从而留下一个大小为零的向量。如果 position 参数大于向量中的最后一个索引号,则返回一个空向量。如果 count 参数使该过程达到或超过向量的末尾,则向量中从 position 到末尾的所有值都会出现在新向量中。

源向量和新向量最终都必须被销毁。即使源向量被留为空向量(大小为零),该过程也绝不会销毁源向量。

用途

提供一种将一个向量的特定元素移动到另一个向量中的机制。

错误

  • 可恢复错误:值向量无效。
  • 可恢复错误:内存不足,无法执行移除。

参考

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