op_prg_mem_copy()
摘要
将源内存块的内容复制到目标内存块中。
注意: 该内核过程是一个仅为向后兼容而保留的宏调用。新代码中请使用 prg_mem_copy()。
语法
op_prg_mem_copy (from_ptr, to_ptr, size)
| 参数 | 类型 | 说明 |
|---|---|---|
from_ptr |
void* |
指向待复制内存块的指针 |
to_ptr |
void* |
指向用于存放复制结果的内存块的指针 [这些指针可以指向任何数据类型,从整数到复杂数据结构。传入指针值的类型转换并非必需,因为实现该内核过程的宏会自动完成转换。但源指针与目标指针应指向同一数据类型,以使目标内存块足以容纳源内存块且不浪费。] |
size |
size_t |
待复制内存块的大小(以字节计) [数据类型的大小可使用 C 语言伪函数 sizeof() 获得,如示例一节所示。] |
返回类型
void
无返回值。
示例
/* receive a packet from the nearest neighbor */
pkptr = op_pk_get (op_intrpt_strm ());
/* extract the log data structure */
op_pk_nfd_get (pkptr, "fd.log", &log_ptr);
/* add information on this node to the log */
log_ptr->node_list [log_ptr->num_nodes] = node_user_id;
log_ptr->num_nodes++;
/* allocate a copy of the log for local use */
local_log_ptr = (Log_DS *) op_prg_mem_alloc (sizeof (Log_DS));
/* produce the copy */
op_prg_mem_copy (log_ptr, local_log_ptr, sizeof (Log_DS));
/* send the packet to the next node */
op_pk_send (pkptr, OUT_STRM);
详情
该内核过程可应用于通过 op_prg_mem_alloc() 动态分配的数据结构或简单数据类型,也可应用于静态定义的数据结构,例如状态变量或临时变量。
警告: 忽视以下限制可能导致仿真错误。
该内核过程只应作用于用户自定义的数据结构,而不应作用于 Riverbed Modeler 定义的数据结构(如 Packet 和 Distribution)。这是因为考虑到数据结构内部的计数与引用机制,原始的复制操作并不具备生成可用副本所需的复杂性处理能力。
包含指向其他数据结构指针的数据结构可以用该内核过程复制,但指针所指向的结构不会被原始的字节传输复制。只要被引用的子结构不被修改,就不会有问题。然而,如果通过父结构的某个副本对子结构进行了修改,所有副本都会受到影响。若这种行为不符合期望,用户的进程代码应遍历原始父结构和副本父结构,手动复制其中的子数据结构。
用途
提供为任何类型的数据结构创建副本的机制。当某数据结构的内容由一个进程创建、却由两个或更多进程使用时,这一机制非常有用。
错误
- 程序中止:段错误。(由于指针参数无效,或某个指针未指向足够大的已分配内存块)
- 可恢复错误:为内存复制指定的大小(
<size>)无效。
参考
- 使用内核过程 op_prg_mem_alloc() 分配一块内存,以便将另一块内存的内容复制其中
- 使用内核过程 op_prg_mem_free() 释放内存块