调用方式
Conditions.spatial.protectedRead(cache, method, ...)
记录依赖项 Conditions.spatial.protectedRead,然后按该名称调用。带命名空间的调用不会传入 self:请使用冒号调用,或自行传入该对象。
作用
来自 Conditions/spatial.lua 的内置辅助函数。
参数
| 名称 | 类型 | 作用 |
|---|---|---|
cache | table | nil | Evaluation-pass cache passed to getCached, or nil to read directly. |
method | function | Function to call; any other value returns false and missing-api. |
... | any | Arguments forwarded to method. |
返回值
| 1 | boolean | True when the call succeeded, as pcall reports it. |
|---|---|---|
| 2 | any | On success, every result of method; on failure, the error message or missing-api. |
版本
内置辅助函数在每个版本上都会注册。不同的是它们读取的游戏 API;某个 API 缺失时,辅助函数会改用后备方案,或返回 nil 并附上原因。
它不直接读取任何游戏 API。
插件如何调用它
- 距离内计数 (evaluate)
local ok,current=protectedRead(cache,UnitGUID,entity.unit) Conditions.spatial.booleanReadlocal ok,result=protectedRead(cache,method,...)
源码
Functions/cache.lua,第 24 行。在游戏中为只读;“复制”会生成一份可编辑的副本。
Conditions.spatial.protectedRead(cache, method, ...)
if type(method)~="function" then return false,"missing-api" end
return pcall(addon.getCached,cache,method,...)