op_prg_cmo_dealloc()
摘要
释放先前分配的一块分类内存。
注意: 该内核过程是一个仅为向后兼容而保留的宏调用。新代码应使用 prg_mem_free()。
语法
op_prg_cmo_dealloc (ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
ptr |
void* |
指向待释放的分类内存对象的指针。 |
返回类型
void
无返回值。
示例
/* Allocate categorized memory object */
cmo_ptr = op_prg_cmo_alloc (host_cmo, strlen (orig_name) + 1);
/* Use categorized memory */
...
/* Finished with categorized memory, so deallocate */
if (cmo_ptr != OPC_NIL)
op_prg_cmo_dealloc (cmo_ptr);
详情
动态分配的内存如果在仿真中已不再有用,应当释放,以便回收供其他用途。仿真或程序执行期间创建的短生命周期数据结构如果不释放,内存用量会不断累积,可能导致因内存不足而不必要地中止。用户有责任确保不将 NIL 或未初始化的指针传给 op_prg_cmo_dealloc()。其他无效指针包括静态声明的内存,例如全局变量或函数的临时变量。
用途
提供一种回收机制,用于回收在仿真或程序执行中已完成其用途的动态分配内存。
错误
- 无。
参考
- 使用 op_prg_cmo_define() 定义新的分类内存对象类型或获取分类内存对象句柄
- 使用 op_prg_cmo_alloc() 使用分类内存对象句柄分配对象
- 使用 op_prg_mem_alloc() 分配通用(非分类)内存
- 使用 op_prg_mem_copy() 复制内存块