调用方式
Conditions.spatial.rangeMember(cache, unit, distance)
记录依赖项 Conditions.spatial.rangeMember,然后按该名称调用。带命名空间的调用不会传入 self:请使用冒号调用,或自行传入该对象。
作用
Decides whether unit is within distance yards from the platform's cached range-check bounds: true when the maximum bound is at or inside distance, false when the minimum bound is beyond it (or equals a nonzero distance), otherwise unavailable.
参数
| 名称 | 类型 | 作用 |
|---|---|---|
cache | table | nil | Evaluation-pass cache passed to getCached, or nil to read directly. |
unit | string | Unit token to check. |
distance | number | Distance in yards. |
返回值
| 1 | boolean | nil | Whether the unit is within distance, or nil when the bounds cannot decide. |
|---|---|---|
| 2 | string | nil | The bounds reader's reason, or range-uncertain. |
版本
内置辅助函数在每个版本上都会注册。不同的是它们读取的游戏 API;某个 API 缺失时,辅助函数会改用后备方案,或返回 nil 并附上原因。
它不直接读取任何游戏 API。
插件如何调用它
Conditions.spatial.nameplateDistanceCountlocal member,why=rangeMember(cache,unit,value.distance)
依赖项
Functions.cache.getCached→Functions.cache.getCachedFunctions.presentation.compareString→Functions.presentation.compareStringFunctions.presentation.nullable→Functions.presentation.nullableFunctions.presentation.playerize→Functions.presentation.playerizeFunctions.values.compare→Functions.values.compareFunctions.values.isin→Functions.values.isin
源码
Conditions/spatial.lua,第 656 行。在游戏中为只读;“复制”会生成一份可编辑的副本。
Conditions.spatial.rangeMember(cache, unit, distance)
local bounds,why=Functions.cache.getCached(cache,addon.Platform.GetRangeCheckBounds,addon.Platform,unit)
if not bounds then return nil,why end
if bounds.maximum and bounds.maximum<=distance then return true end
if bounds.minimum and (bounds.minimum>distance or bounds.minimum>0 and bounds.minimum==distance) then return false end
return nil,"range-uncertain"