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.
参考
- 使用
prg_mem_alloc()分配一个内存块,以便将另一个内存块的内容复制到其中 - 使用
prg_mem_free()释放内存块