prg_list_cell_from_data_get()
摘要
获取包含指定数据的列表首个单元的引用。
语法
prg_list_cell_from_data_get (list_ptr, data_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
list_ptr |
PrgT_List * |
目标列表。 |
data_ptr |
VosT_Address |
要查找的数据。 |
返回类型
PrgT_List_Cell *
所请求的单元;若未找到该数据,则返回 PRGC_NIL。
头文件
prg_list_funcs.h
详情
无。
**警告:**该函数 MT 不安全(线程不安全),相关说明见“Multi-Threading Safety“ 第 11 页。对共享列表的访问必须由外部串行化。
用途:
此函数提供了一种基于数据内容获取列表单元引用的方法。
错误:
- 程序中止:段违例。(由于非法的列表指针或畸形列表)
参考:
- 使用
prg_list_head_cell_get()获取列表头部单元的引用 - 使用
prg_list_cell_next_get()获取列表下一个单元的引用 - 使用
prg_list_cell_from_index_get()基于索引获取单元的引用