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()。其他无效指针包括全局变量或函数临时变量等静态声明的内存。

用途

提供一种回收机制,用于回收在仿真或程序执行中已完成使命的动态分配内存。通用动态分配内存的生命周期如下:

  1. 由 prg_mem_alloc() 分配一块内存,并将其转换为合适的数据结构。
  2. 对该数据结构进行赋值,用于数据存储或通信。
  3. 结构的作用结束后,由 prg_mem_free() 释放其内存块。

错误

  • 程序中止:Segmentation violation.(由于无效的 ptr 参数)
  • 诊断错误:Unable to deallocate unknown memory type.(由于将该函数用于通过程序库之外的接口分配的内存,或将 NIL 指针传入 prg_mem_free())

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com