LPC 源文件使用 .lpc 扩展名,同时完全支持传统的 .c 扩展名。本文介绍驱动如何将 "/std/room"、"/std/room.c" 或 "/std/room.lpc" 这样的名称解析为源文件及已加载的对象。
源文件解析规则
当驱动需要加载文件时,例如调用 load_object()、执行 inherit 语句、通过 clone_object() 克隆尚未加载的对象,或加载配置中指定的 master、simul_efun 文件,会遵循以下规则:
-
显式指定扩展名时,必须精确匹配。
load_object("/foo.c")只查找foo.c;load_object("/foo.lpc")只查找foo.lpc,不会尝试另一种扩展名。 -
未指定扩展名时,优先查找
.lpc,再尝试.c。load_object("/foo")会优先加载foo.lpc;如果该文件不存在,则尝试加载foo.c。 -
找不到匹配的源文件时,调用虚拟对象回调。 驱动会将不带扩展名的名称传给 master 对象的
compile_object()回调。如果该回调未提供对象,则加载失败,load_object()返回0。
对象名称始终不带扩展名
已加载对象的名称,即 file_name()、base_name() 返回的名称,以及对象注册表使用的键,始终是不带扩展名的路径。例如,加载 /std/room.lpc 后,对象名称为 /std/room。
因此,扩展名不会影响对象身份:
find_object("/foo")、find_object("/foo.c")和find_object("/foo.lpc")都会找到同一个已加载对象。load_object()会先查询对象注册表,再访问文件系统。只要对象已经加载,上述任意一种名称写法都会返回该对象;前面的精确匹配规则仅在确实需要从磁盘加载源文件时适用。
程序名称(prog->filename)则有所不同:它记录实际参与编译的文件路径,包含扩展名。inherit_list()、deep_inherit_list()、错误堆栈和编译器诊断信息使用的都是这种名称。include_list() 返回的各个 #include 文件路径也采用相同形式。
object ob = load_object("/std/room"); // 加载 /std/room.lpc
file_name(ob); // 返回 "/std/room"
inherit_list(ob); // 返回 ({ "/std/container.lpc" })
编写可移植的游戏库代码
- 在常规代码中,使用不带扩展名的名称引用对象,例如
"/std/room"。只有确实需要指定某个源文件时,才显式添加扩展名。 - 调用
load_object()或call_other()前,不要自行追加".c"。直接传入对象名称,让驱动解析。 - 与程序名称进行比较时,应兼容
.lpc和.c两种扩展名。例如,将文件路径传给function_exists()后得到的结果,以及inherit_list()返回的条目。
上述完整行为由驱动测试 testsuite/single/tests/efuns/dual_extension.lpc 验证。