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 列表分配内存。

参考:

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