prg_list_cell_data_get()
摘要
快速获取与指定列表单元相关联的数据。
语法
prg_list_cell_data_get (cell_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
cell_ptr |
PrgT_List_Cell * |
目标单元。 |
返回类型
void *
所请求的数据。
头文件
prg_list_funcs.h
详情
此函数以内联定义的方式实现以获得更快的运行速度。不进行任何错误检查来验证单元指针的有效性。
**警告:**该函数 MT 不安全(线程不安全),相关说明见“Multi-Threading Safety“ 第 11 页。对共享列表的访问必须由外部串行化。
用途:
此函数提供了一种快速获取与列表元素相关联的数据的方式。在对链表进行快速迭代时可以使用它。
错误:
- 程序中止:段违例。(由于非法的单元指针或畸形列表)
参考:
- 使用
prg_list_head_cell_get()获取列表头部单元的引用 - 使用
prg_list_cell_next_get()获取列表下一个单元的引用