BT编程语言文档

include_once

功能

运行期引入并执行 BT 文件,但同一个真实文件在当前执行上下文内只执行一次。

语法

参数

参数类型必填默认值说明
pathString要引入的 BT 文件路径。

返回值

类型说明
Any/Empty首次执行时返回被引入文件的返回值;重复引入同一真实文件时返回 Empty。

示例

注意事项

  • 重复判断使用规范化后的真实文件路径,不使用原始字符串路径。
  • once 状态只属于当前执行上下文;Web 的每次请求、桌面 bt.call() 的每次调用都会重新创建状态。
  • include_once 共享文件编译缓存,但不会缓存变量作用域、返回值或执行状态。
  • 无括号语法只支持语句形式;需要把返回值赋给变量时请使用 include_once(path)