op_vvec_value_set()

摘要

为值向量中的特定元素赋值。

语法

op_vvec_value_set (target, position, value)
参数 类型 说明
target Vvec_Vector 要修改的值向量
position unsigned int 要赋值的元素的索引号
value Vartype 要放入向量中 position 处的值

返回类型

Compcode

完成代码,指示赋值操作的成功或失败。

若赋值成功,该过程返回 OPC_COMPCODE_SUCCESS;若无法赋值,则返回 OPC_COMPCODE_FAILURE。例如,当内存不足以扩展向量时可能发生失败。

示例

/* Run through a STDLOGIC value vector and change all occurrences of 'Z' to '0'. */
for (i = 0; i < op_vvec_size (target_vector); i++)
	{
	/* get current value. */
	op_vvec_value_get (target_vector, i, &val);

	/* test for equality. */
	if (val == 'Z')
		{
		op_vvec_value_set (target_vector, i, '0');
		}
	}

详情

对于类型为 OpC_Type_Boolean 或 OpC_Type_Bit 的值向量,不要直接赋值字面值 0 和 1,而应使用相应的常量:

  • 布尔类型使用 OpC_Bool_F 和 OpC_Bool_T
  • 比特类型使用 OpC_Bit_0 和 OpC_Bit_1

如果 position 指定的向量元素位于向量末尾之后,op_vvec_value_set() 会扩展该向量,创建新位置以及将向量增大到新尺寸所需的全部元素。未指定的值将设为以下默认值:

表 23:op_vvec_value_set() 按类型划分的默认值

值类型 默认值
integer 0
double 0.0
pointer OPC_NULL(用于指针)
char \0'(用于 char)
bit OPC_BIT_0
standard logic “0”
boolean OPC_BOOL_F

用途

提供一种为现有值向量中的单个元素赋值的方法。

错误

  • 可恢复错误:值向量无效。
  • 可恢复错误:内存不足,无法在位置(<pos>)处赋值。

参考

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