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>)无效。

参考

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