prg_list_cell_from_index_get()
摘要
获取指定索引处列表单元的引用。
语法
prg_list_cell_from_index_get (list_ptr, index)
| 参数 | 类型 | 说明 |
|---|---|---|
list_ptr |
PrgT_List * |
目标列表。 |
index |
int |
所需单元的索引。 索引从列表头部的 0 开始,逐次加 1 直到尾部。除数字索引外,也可以指定抽象的列表位置索引;可取的值为 PRGC_LISTPOS_HEAD 和 PRGC_LISTPOS_TAIL。 |
返回类型
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_data_get()基于数据内容获取单元的引用 - 使用
prg_list_access()获取与指定索引关联的数据元素的引用