prg_mem_copy_create()

摘要

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

语法

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

返回类型

void *

指向已分配内存块的指针。如果内存分配失败,返回常量 PRGC_NIL。

头文件

prg_mem_funcs.h

示例

/* 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 *) 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() 配合使用,后者返回按名称指定的数据结构所占的字节数。上面的示例展示了 prg_mem_copy_create() 与 sizeof() 的联合使用。

注意: 如果对字符串调用 prg_mem_copy_create() 并使用 strlen() 确定内存长度,终止字符串的 NULL 字节不会被复制。要解决此问题,可使用 prg_string_copy(),或将长度加一,如下所示:char *new_string = prg_mem_copy_create (old_string, strlen (old_string) + 1);

该函数可用于数据结构或简单数据类型。但它只应作用于用户自定义的数据结构,而不应作用于 Riverbed Modeler 定义的数据结构(如 Packet 和 Distribution),因为考虑到其内部的数据结构计数与引用机制,原始复制操作不具备生成可用副本所必需的复杂性(忽视此警告可能导致仿真错误)。

包含指向其他数据结构指针的数据结构可以通过该函数复制,但指针所引用的结构不会被原始的字节传输复制。如果被引用的从属结构不被修改,这不会造成问题。但如果通过父结构的某一个副本对从属结构进行了修改,所有副本都会受到影响。如果不希望如此,用户的进程代码应遍历原始父结构和副本父结构,将各从属数据结构逐一复制。

请注意 prg_mem_alloc() 中关于内存管理的说明。

用途

提供一种方便地创建任意类型数据结构副本的机制。

错误

  • 可恢复错误:Request to allocate (<size>) bytes failed.
  • 程序中止:Segmentation violation.(由于无效的指针参数,或指针未指向足够大的已分配内存块)

参考

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