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

参考

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