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() 调用失败导致)

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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