prg_list_transfer()
摘要
将源列表的内容复制到目标列表(源元素由非 Riverbed API 分配)。
语法
prg_list_transfer (from_list_ptr, to_list_ptr, elem_size)
| 参数 | 类型 | 说明 |
|---|---|---|
from_list_ptr |
PrgT_List * |
指向复制来源列表的指针。 |
to_list_ptr |
PrgT_List * |
指向复制目标列表的指针。 |
elem_size |
size_t |
要复制的元素的大小。 |
返回类型
void
无返回值。
头文件
prg_list_funcs.h
示例:
/* Note: src_list_ptr points to the previously */
/* initialized and populated list of ElemT_Type. */
typedef struct {...} ElemT_Type;
PrgT_List *dest_list_ptr;
/* allocate and initialize new list for copy */
dest_list_ptr = prg_list_create();
prg_list_transfer (src_list_ptr, dest_list_ptr, sizeof (ElemT_Type));
详情
此函数先清空目标列表,然后将源列表的所有元素复制到目标列表。复制从源列表的第一个元素开始。
**警告:**该函数 MT 不安全(线程不安全),相关说明见“Multi-Threading Safety“ 第 11 页。对共享列表的访问必须由外部串行化。
用途:
提供了一种将固定大小的元素从一个链表复制到另一个链表的机制。当元素不是通过已知方法(如 prg_mem_alloc()、prg_str_decomp() 或 prg_gdf_read())分配时,可以使用此内核过程。
错误:
- 程序中止:段违例。(由于无效的列表指针或畸形列表)
- 可恢复错误:无法为 Prg 列表分配内存。
参考:
- 使用内核过程
prg_list_elems_copy()复制元素由 Riverbed 内存分配例程分配的源列表