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