prg_list_size()

摘要

获取指定列表的长度(即列表包含的元素数目)。

语法

prg_list_size (list_ptr)
参数 类型 说明
list_ptr PrgT_List* 指向目标列表的指针。
可以从多个函数获得列表指针:可从 prg_list_create() 获得一个空列表;从 prg_gdf_read() 获得表示文件内容的列表;或者由用户代码分配一个列表并通过 prg_list_init() 初始化。

返回类型

int

指定列表的大小(即存储在列表中的元素地址数目)。空列表的大小为零。

头文件

prg_list_funcs.h

示例:

/* open and read in the contents of a GDF file */
list_ptr = prg_gdf_read (gdf_file_name);

/* loop through the contents of the GDF contents list, */
/* printing each line */
list_size = prg_list_size (list_ptr);
for (i = 0; i < list_size; i++)
	printf ("line %d: [%s]\n", i, (char*) prg_list_access (list_ptr, i));

/* deallocate the elements on the list */
prg_list_free (list_ptr);

/* deallocate the list itself */
prg_mem_free (list_ptr);

详情

当通过 prg_list_create() 创建列表,或通过 prg_list_init() 初始化列表时,列表为空,大小为零。当通过 prg_list_insert() 向列表插入元素时,每次插入使列表大小加 1。当通过 prg_list_remove() 从列表移除元素时,每次移除使列表大小减 1。

**警告:**该函数 MT 不安全(线程不安全),相关说明见“Multi-Threading Safety“ 第 11 页。对共享列表的访问必须由外部串行化。

用途:

提供了一种确定列表内包含的元素数目的机制。当需要顺序扫描列表(通过 prg_list_access()),或消耗并处理列表(通过 prg_list_remove())时,这通常很有用。列表扫描或处理可以通过构造一个对列表中每个元素执行一次的循环来实现,循环次数由本函数给出。在列表扫描的情况下(列表大小不随循环推进而变化),循环索引值可以作为位置索引。

错误:

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

参考:

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