op_prg_list_create()
摘要
分配一个新的空列表。
注意: 该内核过程是一个仅为向后兼容而保留的宏调用。新代码应使用 prg_list_create()。
语法
op_prg_list_create ()
| 参数 | 类型 | 说明 |
|---|---|---|
| 无参数 |
返回类型
List*
指向新创建的空列表的指针。该列表指针通常直接赋给声明为 List* 的变量,如示例小节所示。]
示例
/* allocate an empty list */
lptr = op_prg_list_create ();
/* allocate four parameter block data structures, and insert into list */
temp_ptr = op_prg_mem_alloc (sizeof (struct parm_block));
op_prg_list_insert (lptr, temp_ptr, OPC_LISTPOS_TAIL);
temp_ptr = op_prg_mem_alloc (sizeof (struct parm_block));
op_prg_list_insert (lptr, temp_ptr, OPC_LISTPOS_TAIL);
temp_ptr = op_prg_mem_alloc (sizeof (struct parm_block));
op_prg_list_insert (lptr, temp_ptr, OPC_LISTPOS_TAIL);
temp_ptr = op_prg_mem_alloc (sizeof (struct parm_block));
op_prg_list_insert (lptr, temp_ptr, OPC_LISTPOS_TAIL);
详情
空列表内部不包含任何元素,但已准备好通过内核过程 op_prg_list_insert() 插入元素。可以按任意顺序向列表添加元素。
用途
提供一种获取由仿真内核分配的崭新列表的机制。这是获得空列表的两种方式之一;另一种方式是用户代码自行分配一个列表(可以是静态分配的变量,或位于动态分配的数据结构内),并通过内核过程 op_prg_list_init() 初始化该列表。
错误
- 程序中止:内存分配失败。无法创建列表数据结构。
参考
- 使用内核过程 op_prg_list_insert() 向列表插入元素
- 使用内核过程 op_prg_list_free() 移除并释放列表上的所有元素(保留列表本身)
- 使用内核过程 op_prg_mem_free() 释放不再有用的列表(在其元素已被释放之后)
- 使用内核过程 op_prg_list_init() 在使用动态分配的列表之前对其进行初始化