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() 动态分配列表。

错误:

  • 程序中止:段违例。(由于非法列表指针或畸形列表)

参考:

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