prg_file_output_files_list_get()
摘要
返回某个项目-场景中属于特定类型的类型化文件(typed file)列表。
语法
prg_file_output_files_list_get (type, base_name, optional_suffix)
| 参数 | 类型 | 说明 |
|---|---|---|
type |
PrgT_Tfile_Type |
tfile 类型。必须是第 152 页表 5“Tfile Package Symbolic Constants“中给出的符号常量之一。 |
base_name |
const char * |
所需文件的基础名称(通常是项目-场景名称)。若为 OPC_NIL,则返回所有 type 类型的文件。 |
optional_suffix |
const char * |
可选的文件名后缀,表示所需的运行编号。 |
返回类型
PrgT_List *
所请求文件的列表。
头文件
prg_file_funcs.h
详情
该函数在模型目录(由 “mod_dirs“ 首选项列出)中搜索,并返回满足指定要求(type、base_name 和 optional_suffix)的所有文件的列表。该函数用于收集输出(结果)文件列表,但不会进行类型检查以验证所请求的类型是否为输出文件。若要获取输出文件,将 type 设置为 PrgC_Tfile_Type_Outvector 或 PrgC_Tfile_Type_Anim_Hist。
典型的输出文件名形式为
<pj_name>-<sc_name>[-DES|FLAN[-#]]
其中
<pj_name>是项目名称<sc_name>是场景名称DES|FLAN是来源(离散事件仿真或流分析)#是运行编号
调用者拥有该列表,并负责销毁该列表及其列表元素。