包概述
与许多 C 程序一样,进程模型中的大多数数据存储需求可以通过静态声明的变量来满足。(进程模型可以在临时变量块、状态变量块或头块中包含静态声明。)但有时也需要从堆上动态分配内存,尤其是当进程的内存需求会随其响应的事件序列而变化时。仿真中动态内存的典型用途包括存储用户定义的消息数据结构、用于路由或其他目的的查找表,以及面向连接或会话的记录。仿真中的动态内存管理可以由标准库函数 malloc() 和 free() 完成,但我们建议改用 Memory and Pooled Memory(Mem)包中附加值更高的函数。这些函数提供了对调试有用的额外错误检查与统计功能。
Mem 包提供了管理多种内存类型的函数:
此外,Mem 包还提供了一组用于复制、释放内存和报告内存统计的通用函数。这些函数在通用内存函数一节中说明,适用于上述三种内存类型。
通用内存
通用内存相对于标准函数 malloc() 和 free() 提供了基础层面的改进,为内存附带了额外的错误报告和调试能力。通用内存相关的函数有:
prg_mem_alloc()——分配任意大小的通用内存块(以系统资源为限)。分配的内存会被清零。prg_mem_alloc_dont_clear()——与prg_mem_alloc()功能相同,但不清零所分配的内存块。prg_mem_realloc()——以新的尺寸重新分配通用内存块。
分类内存
分类内存相比通用内存提供了更强的报告能力。使用通用内存时,ODB 或 prg_mem_stats_print() 报告的所有内存用量都混在一起。分类内存允许按特定类别分配内存,这些类别在用量报告中按名称分组。
要使用分类内存,必须用 prg_cmo_define() 或 prg_cmo_define_with_props() 定义一个分类内存对象类型(categorized memory object type)。这些函数返回一个句柄,供 prg_cmo_alloc() 用来分配属于相应类别的内存块(称为分类内存对象,categorized memory objects)。
默认情况下,分类内存对象在分配时会被清零。如果无需清零,可以使用带 PRGC_MEM_DONT_CLEAR 选项的 prg_cmo_define_with_props(),定义一种在分配该类型对象时不清零内存的分类内存对象类型,以节省时间。
每种分类内存对象类型都有唯一的名称。分类内存对象共享其类别的名称,但可以具有不同的块大小。
池化内存
池化内存兼具分类内存的报告优势,并在某些场景下带来显著的性能提升。当需要对相同大小的块执行大量分配时,池化内存可以缩短内存分配时间。此外,每种对象类型的用量都可以通过仿真调试器 ODB 的 memstats 命令和 prg_mem_stats_print() 单独跟踪。
池化内存对象类型通过 prg_pmo_define() 或 prg_pmo_define_with_props() 定义,具有唯一的名称、对象大小和增量计数。定义函数返回的句柄供 prg_pmo_alloc() 用来分配池化内存对象。
图 1:池化内存分配

对象大小指定某一类别中每个池化内存对象使用的存储字节数。增量指定 Mem 包在为该类别获取更多内存时应作为一个块分配的对象数量。当需要满足通过 prg_pmo_alloc() 发起的对象分配时,Mem 包会自动分配新的池化内存块;当块中的所有对象都被释放时,则释放该块。要释放池化内存对象,请使用 prg_pmo_dealloc()。
当增量大小设置得较高时,池化内存分配器的性能最快;但在内存资源非常有限的情况下,过大的增量可能并不理想,因为它可能不必要地占用内存。相反,增量过小会导致池化内存块频繁分配和释放,从而降低性能。虽然合适的增量大小取决于具体的内存分配与释放模式,但通常 25 到 100 之间的值是合适的。
可以用 prg_pmo_define_with_props() 定义池化内存对象类型,使其在分配该类型对象时不清零内存,或在块中所有对象都被释放时不释放内存块。
通用内存函数
以下函数可用于本包管理的三种内存类型:
prg_mem_copy()——将源内存块的内容复制到目标内存块。prg_mem_copy_create()——按指定大小分配一个内存块,并将源内存块的内容复制到新分配的内存块中。prg_mem_free()——释放先前分配的内存块。prg_mem_stats_total_usage_get()——获取指定子类别在通用、池化、分类或全部内存中的总用量。prg_mem_stats_print()——显示包含系统中对象内存用量统计的表格。