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 页。对共享列表的访问必须由外部串行化。
用途:
遍历指定列表,并对其中部分或全部元素应用用户指定的函数。
错误:
- 程序中止:段错误(由于无效的列表指针或格式错误的列表)
参考:
- 无