prg_cmo_alloc()
摘要
分配指定类型的分类内存对象。
语法
prg_cmo_alloc (cm_handle, size)
| 参数 | 类型 | 说明 |
|---|---|---|
cm_handle |
Cmohandle |
指定要分配的分类内存对象类型的分类内存句柄。分类内存句柄可通过 prg_cmo_define() 获得。 |
size |
size_t |
要分配的内存块的大小,以字节计。 |
返回类型
void *
指向所分配的分类内存对象的指针(最低字节的首地址)。如果内存分配失败,则返回常量 PRGC_NIL。
头文件
prg_mem_funcs.h
示例
#include <string.h>
char * copy_host_name (const char * orig_name)
{
static Cmohandle host_cmo = OPC_NIL;
char * new_name;
FIN (copy_host_name);
if (host_cmo == OPC_NIL)
{
/* First invocation, create the category */
host_cmo = prg_cmo_define ("My Host Names");
if (host_cmo == OPC_NIL)
{
op_sim_end ("Unable to create memory category", "", "", "");
}
/* Allocated memory will be filled with original name, */
/* so no need to zero it out. */
prg_cmo_properties_set (host_cmo, PRGC_MEM_DONT_CLEAR);
}
new_name = (char *) prg_cmo_alloc (host_cmo, strlen (orig_name)+1);
if (new_name == OPC_NIL)
{
op_sim_end ("Memory allocation failure", "", "", "");
}
strcpy (new_name, orig_name);
FRET (new_name);
}
详情
动态分配的内存如果在仿真中已不再有用,应当释放,以便回收供其他用途。如果在整个仿真过程中不断创建短生命周期的数据结构而不释放,内存用量会不断累积,可能导致仿真因内存不足而不必要地中止。
通过 prg_cmo_alloc() 分配的内存,可以像通过 prg_mem_alloc() 分配的内存一样,用 prg_mem_free() 释放。
用途
提供一种可在调试期间跟踪记录的动态内存分配机制。每种分类内存对象类型都可以通过仿真调试器 ODB 的 memstats 命令或 prg_mem_stats_print() 函数进行跟踪。
错误
- 可恢复错误:由于分类内存句柄无效,分类内存分配失败。(通常由先前的
prg_cmo_define()调用失败导致)
参考
- 使用
prg_cmo_define()定义新的分类内存对象类型或获取分类内存对象句柄 - 使用
prg_mem_free()释放分类内存对象,使其可被重复使用 - 使用
prg_mem_alloc()分配通用(非分类)内存 - 使用
prg_mem_copy()复制内存块