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() 函数进行跟踪。

错误

  • 无。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com