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.(由于无效的指针参数,或指针未指向足够大的已分配内存块)
参考
- 使用
prg_mem_free()释放内存块 - 使用
prg_mem_alloc()分配内存块 - 使用
prg_mem_copy()复制内存块