prg_list_clear()
摘要
移除存储在链表中的对象,并可选择性地释放它们。
语法
prg_list_clear (list_ptr, dealloc_proc)
| 参数 | 类型 | 说明 |
|---|---|---|
list_ptr |
PrgT_List * |
指向目标列表的指针。 可以从多个函数获得列表指针:最初可从 prg_list_create() 获得一个空列表,从 prg_gdf_read() 获得表示文件内容的列表,或者由用户代码分配一个列表并通过 prg_list_init() 初始化。 |
dealloc_proc |
PrgT_List_Dealloc_Proc |
用于释放内存的过程。 |
返回类型
void
无返回值。
头文件
prg_list_funcs.h
详情
此函数从列表中移除元素,并可选择性地释放它们。调用此函数后,列表将被重新初始化为大小 0。如果 dealloc_proc 为 PRGC_NIL,则不会释放这些元素。若指定了 dealloc_proc,此函数会同时移除并释放列表的元素。如果 dealloc_proc 为 prg_mem_free(),此函数的行为与 prg_list_free() 完全相同。
dealloc_proc 的原型见 PrgT_List_Dealloc_Proc。
**警告:**该函数 MT 不安全(线程不安全),相关说明见“Multi-Threading Safety“ 第 11 页。对共享列表的访问必须由外部串行化。
参考:
- 使用
prg_list_free()移除并释放列表的元素(当元素是使用标准程序库方法分配时) - 使用
prg_list_destroy()销毁列表,包括列表基础结构,并可选择性地销毁列表中的项 - 使用
prg_mem_free()释放列表占用的内存