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 验证。