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())时,这通常很有用。列表扫描或处理可以通过构造一个对列表中每个元素执行一次的循环来实现,循环次数由本函数给出。在列表扫描的情况下(列表大小不随循环推进而变化),循环索引值可以作为位置索引。
错误:
- 程序中止:段违例。(由于无效的列表指针或畸形列表)
参考:
- 使用
prg_list_insert()向列表插入新元素 - 使用
prg_list_remove()从列表中移除元素 - 使用
prg_list_access()获取列表元素的地址而不将其移除