op_prg_list_map()

摘要

对指定列表中的元素应用用户指定的函数。

注意: 该内核过程是一个仅为向后兼容而保留的宏调用。新代码应使用 prg_list_map()。

语法

op_prg_list_map (list_ptr, mapfun, state)
参数 类型 说明
ist_ptr List* 指向目标列表的指针 [列表指针可以从多个内核过程获得:空列表最初可由 op_prg_list_create() 获得,表示文件内容的列表可由 op_prg_gdf_read() 获得,或者列表可由用户代码分配并通过 op_prg_list_init() 初始化。]。
mapfun List_Map_Proc 应用于指定列表每个元素的过程。原型参见详情。
state void* 用作 mapfun 第一个参数的指针。

返回类型

void

无返回值。

示例

/* read a GDF file */
routing_list_ptr = op_prg_gdf_read ("routing_table");

/* Print out the contents of the list by applying */
/* the ’printf’ function to its elements. */
op_prg_list_map (routing_list_ptr, printf, "%s\n");

详情

mapfun 过程从列表表头开始依次应用于列表的每个元素,直到所有元素都被访问,或直到 mapfun 返回 0。Mapfun 的原型如下:

int
List_Map_Proc (void* state, void* elem_ptr)

映射函数的第一个参数是 op_prg_list_map 的 state 参数,第二个参数是列表元素指针。

注意: 该内核过程不是 MT 安全的,如 “Multi-Threading Safety“ 第 11 页所述。对共享列表的访问必须由外部串行化。

用途

对指定列表的全部或部分元素应用用户指定的函数。

错误

  • 程序中止:段错误(由于列表指针无效或列表格式错误)。

参考

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