include_once
include_once
功能
运行期引入并执行 BT 文件，但同一个真实文件在当前执行上下文内只执行一次。
语法
include_once(path) include_once path
参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| path | String | 是 | 无 | 要引入的 BT 文件路径。 |
返回值
| 类型 | 说明 |
|---|---|
| Any/Empty | 首次执行时返回被引入文件的返回值；重复引入同一真实文件时返回 Empty。 |
示例
fs('once-demo.bt').write('counter = counter + 1') counter = 0 include_once 'once-demo.bt' include_once './once-demo.bt' // 输出：1 echo(counter)
注意事项
- 重复判断使用规范化后的真实文件路径，不使用原始字符串路径。
- once 状态只属于当前执行上下文；Web 的每次请求、桌面
bt.call()的每次调用都会重新创建状态。 - include_once 共享文件编译缓存，但不会缓存变量作用域、返回值或执行状态。
- 无括号语法只支持语句形式；需要把返回值赋给变量时请使用
include_once(path)。