op_prg_list_transfer()
摘要
将源列表的内容复制到目标列表(源元素由非 Riverbed API 分配)。
注意: 该内核过程是一个仅为向后兼容而保留的宏调用。新代码应使用 prg_list_transfer()。
语法
op_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
无返回值。
示例
/* 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 = op_prg_list_create();
op_prg_list_transfer (src_list_ptr, dest_list_ptr, sizeof (ElemT_Type));
详情
该函数先清空目标列表,然后将源列表中的所有元素复制到目标列表。复制从源列表的第一个元素开始。
注意: 该内核过程不是 MT 安全的,如 “Multi-Threading Safety“ 第 11 页所述。对共享列表的访问必须由外部串行化。
用途
提供一种将固定大小的元素从一个链表复制到另一个链表的机制。当元素不是通过已知方法(如 op_prg_mem_alloc()、op_prg_str_decomp() 或 op_prg_gdf_read())分配时,可以使用该内核过程。
错误
- 程序中止:段错误。(由于列表指针无效或列表格式错误)
- 可恢复错误:无法为 Prg 列表分配内存。
参考
- 使用内核过程 op_prg_list_elems_copy() 复制元素由 Riverbed 内存分配例程分配的源列表