prg_mem_copy()

摘要

将源内存块的内容复制到目标内存块中。

语法

prg_mem_copy (from_ptr, to_ptr, size)
参数 类型 说明
from_ptr void * 指向待复制内存块的指针
to_ptr void * 指向用于存放副本的内存块的指针。[这些指针可以指向任何数据类型,从整数到复杂数据结构。传入的指针值无需强制类型转换,因为实现该函数的宏会自动完成转换。但源指针和目标指针应指向同一数据类型,以保证目标内存块足够大、能容纳源内存块,且又不浪费。]
size size_t 待复制内存块的大小,以字节为单位。[数据类型的大小可用 C 语言伪函数 sizeof() 获取,如示例一节所示。]

返回类型

void

无返回值。

头文件

prg_mem_funcs.h

示例

/* 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 *) prg_mem_alloc (sizeof (Log_DS));

/* produce the copy */
prg_mem_copy (log_ptr, local_log_ptr, sizeof (Log_DS));

/* send the packet to the next node */
op_pk_send (pkptr, OUT_STRM);

详情

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

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

用途

提供一种方便地创建任意类型数据结构副本的机制。当某个数据结构的内容由一个进程创建、但将由两个或更多进程使用时,这可能很有用。

错误

  • 程序中止:Segmentation violation.(由于无效的指针参数,或某个指针未指向足够大的已分配内存块)
  • 可恢复错误:Invalid size (<size>) specified for memory copy.

参考

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