prg_mem_free()
摘要
释放先前分配的一块内存。
语法
prg_mem_free (ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
ptr |
void * |
指向待释放内存块的指针。传入该函数的指针通常应限于最初从 prg_mem_alloc() 获得的指针(不过如示例一节所示,prg_gdf_read() 产生的动态分配数据结构也可以用该函数释放)。 |
返回类型
void
无返回值。
头文件
prg_mem_funcs.h
示例
/* open and read in the contents of a GDF file */
list_ptr = prg_gdf_read (gdf_file_name);
/* loop through the contents of the GDF contents list, */
/* printing each line */
list_size = prg_list_size (list_ptr);
for (i = 0; i < list_size; i++)
printf ("line %d: [%s]\n", i, (char*) prg_list_access (list_ptr, i));
/* deallocate the elements on the list */
prg_list_free (list_ptr);
/* deallocate the list itself */
prg_mem_free (list_ptr);
详情
动态分配的内存如果在仿真中、或在 EMA 或 ETS 程序执行中已不再有用,应当释放,以便回收供其他用途使用。在仿真或程序执行过程中创建的短生命周期数据结构如果不释放,会使内存用量持续增长,可能因内存不足导致不必要的中止。用户有责任确保不将 NIL 或未初始化的指针传入 prg_mem_free()。其他无效指针包括全局变量或函数临时变量等静态声明的内存。
用途
提供一种回收机制,用于回收在仿真或程序执行中已完成使命的动态分配内存。通用动态分配内存的生命周期如下:
- 由
prg_mem_alloc()分配一块内存,并将其转换为合适的数据结构。 - 对该数据结构进行赋值,用于数据存储或通信。
- 结构的作用结束后,由
prg_mem_free()释放其内存块。
错误
- 程序中止:Segmentation violation.(由于无效的 ptr 参数)
- 诊断错误:Unable to deallocate unknown memory type.(由于将该函数用于通过程序库之外的接口分配的内存,或将 NIL 指针传入
prg_mem_free())
参考
- 使用
prg_mem_alloc()分配内存块 - 使用
prg_mem_copy()复制内存块