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() 初始化该列表。

错误

  • 程序中止:内存分配失败。无法创建列表数据结构。

参考

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