Conditions.spatial_stats.observation

Как вызывать

Conditions.spatial_stats.observation(cache, method, unit, power)

Запишите зависимость Conditions.spatial_stats.observation и вызывайте её по этому имени. Вызов через пространство имён не передаёт self: используйте вызов через двоеточие или передайте объект сами.

Что делает

Reads one health or mana number for a PROXIMITY_* condition through the evaluation cache, protected against errors. With power set it passes Enum.PowerType.Mana as the second argument; restricted, negative, NaN or infinite readings are rejected.

Аргументы

Имя	Тип	Что делает
`cache`	`table \| nil`	Evaluation-pass cache passed to getCached, or nil to read directly.
`method`	`function`	API to call, such as UnitHealth or UnitPowerMax.
`unit`	`string`	Unit token to read.
`power`	`boolean \| nil`	Truthy to read mana.

Возвращает

1	`number \| nil`	The reading, or nil when unavailable.
2	`string \| nil`	Reason for nil: missing-api, api-error, restricted-value or statistic-unavailable.

Издания

Встроенные помощники регистрируются во всех изданиях. Различается игровой API, который они читают; если нужного API нет, помощник использует запасной вариант или возвращает nil с причиной.

Недоступно в этом издании (причина — во всплывающей подсказке)
Только пока включены запасные реализации Blizzard для устаревших функций

Игровой API
`Enum.PowerType`

Секретные значения (Retail и Forever)

В Retail и Forever игра передаёт аддонам секретные значения. Этот помощник проверяет то, что читает (addon.Platform:CanReadValue), и вместо секретного значения, которое нельзя сравнить, возвращает nil с причиной, например restricted-value. Считайте nil недоступным значением, а не ложью.

Как его вызывает аддон

Conditions.spatial_stats.statistic

local current,reason=observation(cache,method,unit,mana)

Исходный код

Conditions/spatial_stats.lua, строка 60. В игре только для чтения; «Дублировать» создаёт редактируемую копию.

Conditions.spatial_stats.observation(cache, method, unit, power)

    if type(method)~="function" then return nil,"missing-api" end
    local ok,current
    if power then ok,current=pcall(addon.getCached,cache,method,unit,Enum.PowerType.Mana)
    else ok,current=pcall(addon.getCached,cache,method,unit) end
    if not ok then return nil,"api-error" end
    if not addon.Platform:CanReadValue(current) then return nil,"restricted-value" end
    if type(current)~="number" or current~=current or current<0 or current==math.huge then return nil,"statistic-unavailable" end
    return current

Назад: Справочник функций