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>)处赋值。
参考
- 使用内核过程 op_vvec_value_get() 从值向量中取值
- 使用内核过程 op_vvec_create() 创建一个新值向量
- 使用内核过程 op_vvec_copy() 创建一个包含另一个值向量副本的新值向量
- 使用内核过程 op_vvec_destroy() 释放与值向量关联的内存