op_vvec_create()
摘要
创建一个新的向量,其中不含任何元素,但可以存放指定类型的元素。
语法
op_vvec_create (type)
| 参数 | 类型 | 说明 |
|---|---|---|
type |
OpT_Value_Type |
该向量将存放的值的数据类型。必须是 Table 98 “Value Vector Type Symbolic Constants“ 第 35 页 中列出的值之一。 |
返回类型
Vvec_Vector
新的空值向量。
示例
/* Create a new value vector to maintain error strings. */
error_vector = op_vvec_create (OpC_Type_String);
/* insert several packet pointers into the vector. */
op_vvec_value_set (packet_vector, OPC_VVEC_VECTOR_END, "Timeout expired");
op_vvec_value_set (packet_vector, OPC_VVEC_VECTOR_END, "Packet is corrupt");
op_vvec_value_set (packet_vector, OPC_VVEC_VECTOR_END,
"Unknown packet header format");
详情
与数组不同,向量的长度无需指定,而且长度可以因其他操作而改变。然而,放入向量的所有元素必须是指定 type 参数所指定的类型。
用途
提供一种创建向量的机制,所创建的向量随后可接收值。
错误
- 不捕获任何错误。
参考
- 使用内核过程 op_vvec_copy() 创建一个作为已存在向量副本的新值向量
- 使用内核过程 op_vvec_destroy() 释放分配给向量的内存
- 使用内核过程 op_vvec_remove() 创建一个由从另一个向量中移除的元素构成的新向量
- 使用内核过程 op_vvec_value_get() 将值向量中某个特定元素的值复制到一个变量
- 使用内核过程 op_vvec_value_set() 为值向量中的特定元素赋值