prg_list_destroy()

摘要

销毁一个列表,包括列表基础结构,并可选择性地销毁列表中的项

语法

prg_list_destroy (list_ptr, dealloc_elements)
参数 类型 说明
list_ptr PrgT_List * 要销毁的列表
dealloc_elements int 按布尔值处理;为 TRUE 时元素将被释放,否则元素不受本次调用影响。

返回类型

void

无返回值

头文件

prg_list_funcs.h

详情

这是销毁列表的另一种方式,可替代 prg_list_free()。prg_list_free() 总是释放列表中的元素,但不会销毁列表容器。换句话说,prg_list_free() 会清空列表并释放所有元素(尽可能调用合适的内存释放器),但空列表之后仍可作为容器继续使用。如果想销毁容器本身,则必须对列表指针调用 prg_mem_free()。

相比之下,prg_list_destroy() 不会留下任何可用的列表,并且还可以控制是否释放列表的元素。换句话说,可以用 prg_list_destroy() 在一次调用中消除一个列表,并可选择同时释放列表中的元素。如果这些元素是指向销毁完成后仍希望保留的数据的指针(即列表只是这些数据元素的一种“视图”或“排列”),则应指定不释放元素。

**警告:**该函数 MT 不安全(线程不安全),相关说明见“Multi-Threading Safety“ 第 11 页。对共享列表的访问必须由外部串行化。

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com