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>)字节失败。 - 程序中止:段错误。(由于指针参数无效,或指针未指向足够大的已分配内存块)
参考
- 使用内核过程 op_prg_mem_free() 释放内存块
- 使用内核过程 op_prg_mem_alloc() 分配内存块
- 使用内核过程 op_prg_mem_copy() 复制内存块