prg_list_create()
摘要
分配一个新的空列表。
语法
prg_list_create()
| 参数 | 类型 | 说明 |
|---|---|---|
| 无参数 |
返回类型
PrgT_List *
指向新创建的空列表的指针。该指针通常直接赋给声明为 PrgT_List * 的变量,如示例部分所示。
头文件
prg_list_funcs.h
示例:
/* allocate an empty list */
lptr = prg_list_create ();
/* allocate four parameter block data structures, and insert into list */
temp_ptr = prg_mem_alloc (sizeof (struct parm_block));
prg_list_insert (lptr, temp_ptr, PRGC_LISTPOS_TAIL);
temp_ptr = prg_mem_alloc (sizeof (struct parm_block));
prg_list_insert (lptr, temp_ptr, PRGC_LISTPOS_TAIL);
temp_ptr = prg_mem_alloc (sizeof (struct parm_block));
prg_list_insert (lptr, temp_ptr, PRGC_LISTPOS_TAIL);
temp_ptr = prg_mem_alloc (sizeof (struct parm_block));
prg_list_insert (lptr, temp_ptr, PRGC_LISTPOS_TAIL);
详情
空列表中没有元素,但已准备好通过 prg_list_insert() 插入元素。元素可以按任意顺序添加到列表中。
**警告:**该函数 MT 不安全(线程不安全),相关说明见“Multi-Threading Safety“ 第 11 页。对共享列表的访问必须由外部串行化。
用途:
提供了一种获取全新列表的机制。
这是获取空列表的两种方法之一。另一种方法是用户代码自行分配一个列表(通过静态分配的变量,或在动态分配的数据结构内部),并通过 prg_list_init() 初始化该列表。
错误:
- 程序中止:内存分配失败。无法创建列表数据结构。
参考:
- 使用
prg_list_insert()向列表插入元素 - 使用
prg_list_free()移除并释放列表上的所有元素(保留列表本身) - 使用
prg_mem_free()释放不再有用的列表(在其元素已被释放之后) - 使用
prg_list_init()在使用静态分配的列表之前对其进行初始化