op_prg_mem_copy_create()

摘要

按指定大小分配一块内存,然后将源内存块的内容复制到新分配的内存块中。

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

语法

op_prg_mem_copy_create (value, alloc_size)
参数 类型 说明
value void* 指向待复制内存的指针
alloc_size size_t 请求分配的内存字节数

返回类型

void*

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

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

示例

/* obtain the document request message from the request array */
doc_req_msg = Doc_Req_Array [next_request++];

/* copy the document request message */
doc_req_msg = (Doc_Req_Msg *) op_prg_mem_copy_create (orig_req_msg, sizeof 
	(Doc_Req_Msg));

/* process the request */
doc_request_message_process (doc_req_msg);

/* store the processed request in the outgoing array */
Doc_Ans_Array [next_answer++] = doc_req_msg;

详情

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

警告: 忽视以下限制可能导致仿真错误。

该内核过程可应用于数据结构或简单数据类型,但只应作用于用户自定义的数据结构,而不应作用于 Riverbed Modeler 定义的数据结构(如 Packet 和 Distribution)。这是因为考虑到数据结构内部的计数与引用机制,原始的复制操作并不具备生成可用副本所需的复杂性处理能力。

包含指向其他数据结构指针的数据结构可以用该内核过程复制,但指针所指向的结构不会被原始的字节传输复制。只要被引用的子结构不被修改,就不会有问题。然而,如果通过父结构的某个副本对子结构进行了修改,所有副本都会受到影响。若这种行为不符合期望,用户的进程代码应遍历原始父结构和副本父结构,手动复制其中的子数据结构。

另请注意内核过程 op_prg_mem_alloc() 中关于内存管理的说明。

用途

提供先创建指定大小的内存块、再将任何类型的数据结构复制进新分配内存块的机制。

错误

  • 可恢复错误:请求分配(<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