prg_list_init()
摘要
初始化已由用户代码分配的现有列表。
语法
prg_list_init (list_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
list_ptr |
PrgT_List* |
指向目标列表的指针。 获取列表指针的途径有多种:空列表可由 prg_list_create() 获得;表示文件内容的列表可由 prg_gdf_read() 获得;也可以由用户代码分配列表并通过 prg_list_init() 初始化。 |
返回类型
void
无返回值
头文件
prg_list_funcs.h
示例:
/* allocate a list */
list_ptr = (PrgT_List *) prg_mem_alloc (sizeof (PrgT_List));
/* initialize a list */
prg_list_init (list_ptr);
/** move the contents of subqueue #0 into the list **/
/* determine the number of packets in the subqueue */
subq_size = op_subq_stat (0, OPC_QSTAT_PKSIZE);
for (i = 0; i < subq_size; i++)
{
/* take a single packet from the subqueue head */
pkptr = op_subq_pk_remove (0, OPC_QPOS_HEAD);
/* insert the packet onto the list tail */
prg_list_insert (list_ptr, pkptr, PRGC_LISTPOS_TAIL); }
详情
该函数在列表数据结构内部设置初始值,将其置为空状态。在其他任何 prg_list 函数应用于用户代码分配的列表(即不是从 prg_list_create() 获得的列表指针)之前,必须先对其应用该函数。
**警告:**该函数 MT 不安全(线程不安全),相关说明见“Multi-Threading Safety“ 第 11 页。对共享列表的访问必须由外部串行化。
用途:
提供一种机制,用于准备完全由用户代码分配的全新列表(无论是静态分配的变量,还是动态分配的数据结构内部的列表)。这是获得空列表的两种途径之一;另一种途径是让 Program Library 通过 prg_list_create() 动态分配列表。
错误:
- 程序中止:段违例。(由于非法列表指针或畸形列表)
参考:
- 使用
prg_list_create()让 Program Library 分配一个新的空列表 - 使用
prg_list_insert()向列表中插入元素 - 使用
prg_list_free()移除并释放列表上的所有元素(保留列表本身) - 使用
prg_mem_free()在释放列表元素之后释放不再有用的列表