op_vvec_destroy()
摘要
销毁一个值向量并释放与其关联的内存。
语法
op_vvec_destroy (vvector)
| 参数 | 类型 | 说明 |
|---|---|---|
vvector |
Vvec_Vector |
待销毁的值向量 |
返回类型
void
无返回值。
示例
/* Send some data to an esys interface */
head = op_vvec_remove (vvec, OPC_VVEC_VECTOR_START, 16);
/* Schedule values on the esys vector interface */
op_esys_interface_vector_set (interface_id, op_sim_time(), head, 0);
/* finished with this value vector. */
op_vvec_destroy (head);
详情
在最后一次使用某个值向量之后,应当通过销毁该值向量来释放分配给它的内存。如果未能销毁不再会被使用的值向量,可能导致虚拟内存被占满,从而在仿真内核尝试为新对象分配内存时产生错误消息或导致仿真崩溃。
用途
提供一种释放不再需要的值向量所关联内存的机制。应在最后一次访问某个值向量之后调用该内核过程。它返回之后,该值向量即被视为无效,因此不能再被引用或传递给内核过程。
错误
- 可恢复错误:值向量无效。
参考
- 使用内核过程 op_vvec_create() 创建一个新向量
- 使用内核过程 op_vvec_copy() 创建一个由从另一个向量中移除的元素构成的新向量