prg_tfile_path_get()
摘要
返回指定模型文件的完整操作系统文件路径。
语法
prg_tfile_path_get (model_name, type, path_buf, buflen)
| 参数 | 类型 | 说明 |
|---|---|---|
model_name |
const char * |
目标模型的名称。 |
type |
PrgT_Tfile_Type |
目标模型文件的类型。用于指定模型类型的常量列表见表 5 Tfile 包符号常量。 |
path_buf |
char * |
用于存放路径字符串的缓冲区 |
buflen |
int |
path_buf 的长度 |
返回类型
PrgT_Compcode
若模型文件不存在或没有可识别的头部块,返回 PrgC_Compcode_Failure;否则返回 PrgC_Compcode_Success。
头文件
prg_file_funcs.h
详情
此函数返回一个字符串,给出指定模型文件(由名称和类型指定)的完整路径。路径写入 path_buf。如果路径长度超过 buflen,将被截断为 buflen - 1 个字符。
如果模型文件不存在,或者该文件是在应用程序启动之后、或用户上次运行 File > Model Files > Refresh Model Directories 操作之后在应用程序之外创建的,此函数会失败。
如果该文件有可能是在类型化文件(tfile)系统之外被创建、移动或删除的,应改用 prg_tfile_path_rediscover()。它会在所有模型目录中搜索指定文件。