Conditions.spatial.rangeMember

呼叫方式

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.nameplateDistanceCount

local member,why=rangeMember(cache,unit,value.distance)

相依項目

Functions.cache.getCached → Functions.cache.getCached
Functions.presentation.compareString → Functions.presentation.compareString
Functions.presentation.nullable → Functions.presentation.nullable
Functions.presentation.playerize → Functions.presentation.playerize
Functions.values.compare → Functions.values.compare
Functions.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"

返回函式參考