prg_mem_alloc_dont_clear()
摘要
分配一块指定大小且未清零的内存,供一般用途使用。
语法
prg_mem_alloc_dont_clear (size)
| 参数 | 类型 | 说明 |
|---|---|---|
size |
size_t |
请求分配的字节数。为数据结构分配内存时,通常可使用 C 语言伪函数 sizeof() 得到待分配结构的大小,如示例一节所示。 |
返回类型
void *
指向已分配内存块的指针。如果内存分配失败,返回常量 PRGC_NIL。所分配的内存块未经初始化,不应假定其内容已置零。
头文件
prg_mem_funcs.h
示例
void * copy_mem_ptr;
/* no need to pre-initialize dest memory block as it will be overwritten */
/* by a shallow src memory copy */
copy_mem_ptr = prg_mem_alloc_dont_clear (src_mem_size);
/* shallow copy src memory */
memcpy (copy_mem_ptr, src_mem_ptr, src_mem_size);
详情
动态分配的内存如果在仿真、EMA 或 ET 可执行程序中已不再有用,应当释放,以便回收供其他用途使用。在仿真或程序执行过程中不断创建的短生命周期数据结构如果不释放,会使内存用量持续增长,可能因内存不足导致不必要的中止。
通过该函数分配的内存由程序库(Program Library)在“prg memory”类别下跟踪,其使用统计可通过 OPNET 调试器(ODB)命令 memstats、memsrc 和 memsnk,或 prg_mem_stats_print() 函数获取。
该函数常与 C 语言伪函数 sizeof() 配合使用,后者返回按名称指定的数据结构所占的字节数。上一页的示例展示了 prg_mem_alloc_dont_clear() 与 sizeof() 的联合使用。
用途
提供一种动态分配内存的机制。典型用途是创建生命周期有限的数据结构实例(例如保存会话、文件传输等参数的记录)。该函数类似于 malloc() 函数并基于其实现,但增加了以下价值:
- 如果因内存不足导致分配失败,会自动打印并记录错误消息。
- 分配的内存量会被监控,以便在发生分配错误时或通过调试器命令进行报告。
- 通过该函数分配的内存适合与 Prg 包中的其他函数(如
prg_list_free()和prg_list_elems_copy())配合使用,而通过malloc()分配的内存则不适合。
错误
- 可恢复错误:Request to allocate (<size>) bytes of Prg memory failed.
参考
- 使用
prg_mem_free()释放先前分配的内存块 - 使用
prg_mem_copy()复制内存块 - 使用
prg_mem_alloc()分配内存块并清零