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() 释放列表占用的内存

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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