prg_list_cell_remove()
摘要
快速从链表中移除一个单元。
语法
prg_list_cell_remove (list_ptr, cell_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
list_ptr |
PrgT_List * |
目标列表 |
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()获取列表下一个单元的引用 - 使用
prg_list_cell_data_get()获取与特定单元关联的数据