op_prg_cmo_define()
摘要
定义一种新的分类内存对象类型,并返回在分配此类对象时使用的句柄。
注意: 该内核过程是一个仅为向后兼容而保留的宏调用。新代码应使用 prg_cmo_define()。
语法
op_prg_cmo_define (name)
| 参数 | 类型 | 说明 |
|---|---|---|
name |
const char * |
分类内存类型的名称。可以是普通字符串,必要时可包含空格。该名称用于在内存跟踪报告和跟踪语句中标识分类内存对象类型(例如参见 ODB 的 memstats 命令或 prg_mem_stats_print() 函数)。 |
返回类型
Cmohandle
分类内存对象句柄,用于标识新定义的内存类型。在分配单个对象时,该句柄可用于调用 op_prg_cmo_alloc()。
示例
#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 = op_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 *) op_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 参数调用 op_prg_cmo_define() 来创建分类内存类型。不过,冗余的调用会被检测到且不产生效果。在这种情况下,每次调用都会返回等效的句柄,该函数起到一种会合机制的作用,使模型的多个组件无需全局变量即可共享一种分类内存类型。
可以在每次分配之前都尝试创建分类内存类型,但这并不可取。应当避免这样做,因为相对于 op_prg_cmo_alloc()(对每次分配而言已经足够),op_prg_cmo_define() 函数的计算开销更大。
用途
创建新的分类内存对象类型,以便通过 op_prg_cmo_alloc() 函数执行分配。每种分类内存对象类型都可以通过仿真调试器 ODB 的 memstats 命令或 prg_mem_stats_print() 函数进行跟踪。
错误
- 无。
参考
- 使用 op_prg_cmo_alloc() 使用分类内存对象句柄分配对象
- 使用 op_prg_cmo_dealloc() 释放分类内存对象,使其可被重复使用
- 使用 op_prg_mem_alloc() 分配通用(非分类)内存
- 使用 op_prg_mem_copy() 复制内存块