prg_tfile_name_list_get()
摘要
返回一个模型文件名列表。
语法
prg_tfile_name_list_get (type)
| 参数 | 类型 | 说明 |
|---|---|---|
type |
PrgT_Tfile_Type |
目标模型文件类型。用于指定模型类型的常量列表见表 5。 |
返回类型
Prg_List*
返回指向列表的指针,列表中包含与请求类型对应的文件名称。这些文件名不带扩展名,对应用户 "mod_dirs" 设置下"可见"的文件。
头文件
prg_file_funcs.h
示例
/* Obtain a list of network models. */
file_list = prg_tfile_name_list_get (PrgC_Tfile_Type_Network);
printf ("Network files\n");
if (file_list) {
op_prg_list_map (file_list, prg_test_map_string_fast, 0);
}
/* Obtain a list of node models. */
file_list = prg_tfile_name_list_get (PrgC_Tfile_Type_Node);
printf ("Node files\n");
if (file_list) {
op_prg_list_map (file_list, prg_test_map_string_fast, 0);
}
/* Obtain a list of process models. */
file_list = prg_tfile_name_list_get (PrgC_Tfile_Type_Process);
printf ("Process files\n");
if (file_list) {
p_prg_list_map (file_list, prg_test_map_string_fast, 0);
}
详情
可用的模型文件受此函数运行环境的限制。"mod_dirs" 首选项指定了为获取模型名称而要搜索的模型目录列表。此函数返回的模型文件列表在不再需要时,应通过调用 prg_list_free() 和 prg_mem_free() 释放。
列表中存储的模型名称是基本名称,不带 .nt.m 或 .ex.o 之类的扩展名。
目的
提供了一种从系统获取指定类型模型名称的机制。这些名称可用于后续打开和读取模型文件的调用,或显示模型名称以供进一步处理。
错误
- 无
参考
- 使用
prg_list_access()访问列表中的元素。 - 使用
prg_list_free()释放模型名称列表中的元素 - 使用
prg_mem_free()在释放列表元素之后,释放不再有用的列表本身