op_prg_mem_alloc()

摘要

按指定大小分配一块通用用途的内存。

注意: 该内核过程是一个仅为向后兼容而保留的宏调用。新代码中请使用 prg_mem_alloc()。

语法

op_prg_mem_alloc (size)
参数 类型 说明
size size_t 请求分配的内存字节数
为数据结构分配内存时,通常可使用 C 语言的伪函数 sizeof() 来获得待分配结构的大小,如示例一节所示。

返回类型

void*

指向所分配内存块的指针。若内存分配失败,返回常量 OPC_NIL。

这个“通用”指针应被转换为合适的数据类型后再访问。

示例

/* allocate a document request message */
doc_req_msg = (Doc_Req_Msg *) op_prg_mem_alloc (sizeof (Doc_Req_Msg));

/* fill in the message’s fields */
sprintf (doc_req_msg->doc_name, "%s", app_doc_name);
doc_req_msg->priority = STD_PRI;
doc_req_msg->buffer_size = 4 * MBYTE;

/* assign the message to the outgoing packet */
pkptr = op_pk_get (IN_STRM);
op_pk_nfd_set (pkptr, "message_slot", (int) doc_req_msg);
op_pk_send (pkptr, OUT_STRM);

详情

动态分配的内存如果在仿真中不再有用,应当释放以便复用。仿真过程中不断创建的短生命周期数据结构若不释放,会使内存占用持续增长,可能导致仿真因内存不足而不必要地中止。

通过该内核过程分配的内存由仿真内核在“prg_mem blocks”类别下跟踪。可通过仿真调试器(ODB)命令 memstats、memsrc 和 memsnk 获取其使用情况的统计量。

该内核过程常与 C 语言伪函数 sizeof() 配合使用;sizeof() 返回按名称指定的数据结构的大小(以字节计)。上一页的示例展示了 op_prg_mem_alloc() 与 sizeof() 的联合使用。

通过 op_prg_mem_alloc() 分配内存块时,在返回其地址之前,其中每个字节都会被置为零。这保证了当用户自定义逻辑未完全初始化所分配结构时的行为一致性。

用途

提供动态分配内存的机制。典型用途是创建生命周期有限的数据结构实例(例如保存会话、文件传输等参数的记录)。该内核过程与 malloc() 函数类似,但具有以下附加特性:

  • 若因内存不足导致分配失败,会自动打印并记录一条错误消息。
  • 所分配的内存量会被监控,用于错误报告和调试器信息。
  • 通过该内核过程分配的内存适合与 Prg 包中的其他内核过程(如 op_prg_list_free() 和 op_prg_list_elems_copy())配合使用,而通过 malloc() 分配的内存则不适合。

错误

  • 可恢复错误:请求分配(<size>)字节失败。

参考

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