prg_cmo_define()
摘要
定义一种新的分类内存对象类型,并返回用于分配此类对象的句柄。
语法
prg_cmo_define (name)
| 参数 | 类型 | 说明 |
|---|---|---|
name |
const char * |
分类内存类型的名称。可以是普通字符串,必要时可包含空格。该名称用于在内存跟踪报告和跟踪语句中标识分类内存对象类型(例如参见 ODB 的 memstats 命令或 prg_mem_stats_print() 函数)。 |
返回类型
Cmohandle
用于标识新定义内存类型的分类内存对象句柄。在分配单个对象时,可用该句柄调用 prg_cmo_alloc()。
头文件
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);
}
详情
该函数返回的分类内存句柄通常保存在进程的状态变量中,以便此后随时用于分配。多个进程或用户代码段可以分别使用相同的 name 参数调用 prg_cmo_define() 来创建分类内存类型。不过,冗余调用会被检测出来且不产生效果。在这种情况下,每次调用都会返回等价的句柄,该函数起到一种会合(rendezvous)机制的作用,使模型的多个组件无需全局变量即可共享一种分类内存类型。
注意,在每次分配之前都尝试创建分类内存类型虽然可行,但并不可取,因为相对于每次分配已经足够的 prg_cmo_alloc() 函数而言,prg_cmo_define() 函数的计算开销较大。
用途
创建新的分类内存对象类型,以便通过 prg_cmo_alloc() 函数执行分配。每种分类内存对象类型都可以通过仿真调试器 ODB 的 memstats 命令或 prg_mem_stats_print() 函数进行跟踪。
错误
- 无。
参考
- 使用
prg_cmo_define_with_props()定义具有自定义属性的分类内存对象类型 - 使用
prg_cmo_alloc()通过分类内存对象句柄分配对象 - 使用
prg_mem_free()释放分类内存对象 - 使用
prg_mem_alloc()分配通用(非分类)内存 - 使用
prg_mem_copy()复制内存块