op_vvec_copy()

摘要

返回一个新的值向量,其中包含与原始值向量相同的元素;从原始向量中指定的位置开始,包含 count 个元素。

语法

op_vvec_copy (original, position, count)
参数 类型 说明
original Vvec_Vector 要被复制的值向量
position unsigned int 要复制的第一个值的起始位置
[值向量的第一个位置的索引为 0。也可以使用任意值向量位置常量来指示该过程的起始位置(参见 Table 99 “Value Vector Position Symbolic Constants“ 第 35 页)。]
count unsigned int 要复制的值的个数
[将 position 设为 0 并将 count 设为 OPC_VVEC_COUNT_ALL,即可复制整个向量。]

返回类型

Vvec_vector

新的值向量

[该过程创建一个新向量,其中包含从 position 开始的原始向量中的元素。共有 count 个元素被复制到新向量。]

示例

/* Retain a copy of a vector being manipulated. */
Vvec_Vector   copy_vector = op_vvec_copy (target_vector, OPC_VVEC_VECTOR_START,
	OPC_VVEC_COUNT_ALL);

/* now change all characters in the target vector to upper case. */
for (i = 0; i < op_vvec_size_get (target_vector); i++)
	{
	/* Get current vector value */
	op_vvec_value_get (target_vector, i, &c);

	/* Modify if lower-case. */
	if (islower (c))
		c = toupper (c);

	/* Modify target vector. */
	op_vvec_value_set (target_vector, i, c);
	}

/* copy_vector still contains original values in target_vector. */

详情

由 op_vvec_copy() 得到的向量可以赋值给一个先前已声明但尚未定义的向量。或者,也可以使用这个过程对值向量的副本执行操作,同时保持原始向量不变。

例如,如果原始向量包含元素 {1, 2, 3, 4, 5},position 为 1,count 为 3,则 op_vvec_copy() 返回以下值向量:

  • {2, 3, 4}

然而,如果使用同一个原始向量,并将 position 设为 0、count 设为 OPC_VVEC_COUNT_ALL,则得到以下向量:

  • {1, 2, 3, 4, 5}

用途

提供一种复制值向量的方法。

错误

  • 可恢复错误:值向量无效。
  • 可恢复错误:内存不足,无法复制(<count>)个值。
  • 可恢复错误:位置(<pos>)至(<pos>)处的值无法被复制。

参考

  • 使用内核过程 op_vvec_create() 创建一个新向量
  • 使用内核过程 op_vvec_insert() 将一个向量中的元素放入另一个向量
  • 使用内核过程 op_vvec_remove() 创建一个由从另一个向量中移除的元素构成的新向量

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