prg_list_map()

摘要

将映射函数应用于 list_ptr 列表的各元素。

语法

prg_list_map (list_ptr, mapfun, state)
参数 类型 说明
list_ptr PrgT_List* 指向目标列表的指针
mapfun PrgT_List_Map_Proc 应用于列表元素的函数。
state Vartype* 调用 mapfun 时向其传递的状态数据。

返回类型

void

无返回值

头文件

prg_list_funcs.h

示例:

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

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

详情

映射函数 mapfun 从列表头部开始依次作用于每个元素,直到所有元素都被访问,或 mapfun 返回 0。mapfun 的原型见 PrgT_List_Map_Proc。

**警告:**该函数 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