utils.getCachedInternal

Как вызывать

utils.getCachedInternal(cache, recordnil, func, ...)

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

Что делает

Поставляемый помощник из utils.lua.

Аргументы

Имя	Тип	Что делает
`cache`	`table \| nil`	Evaluation-pass cache, or nil to call func directly without caching.
`recordnil`	`boolean`	True to cache every result, including all-nil ones (getCached); false to cache only results with a non-nil value (getRetryCached).
`func`	`function \| string`	Function to call, or the name of a global function; anything else returns nothing.
`...`	`any`	Arguments forwarded to func and used as the exact cache key; a restricted or NaN argument bypasses the cache.

Возвращает

1	`...`	Every result of func, preserving nil positions and the return count; cached results are replayed on later calls with the same arguments.

Издания

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

Не читает игровой API напрямую.

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

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

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

Functions.cache.getCached

return getCachedInternal(cache, true, func, ...)

Functions.cache.getRetryCached

return getCachedInternal(cache, false, func, ...)

Зависимости

_G (builtin:utils.lua:_G)
cacheHits (builtin:utils.lua:cacheHits)
cacheMisses (builtin:utils.lua:cacheMisses)
cachedResult (builtin:utils.lua:cachedResult)
nilArgument (builtin:utils.lua:nilArgument)
packResults → utils.packResults

Исходный код

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

utils.getCachedInternal(cache, recordnil, func, ...)

    if type(func) == 'string' then func = _G[func] end
    if type(func) ~= 'function' then return end
    if cache == nil then return func(...) end

    -- Exact keys preserve argument types, identity and arity. Hashing concatenated
    -- strings allowed unrelated observations to collide, even for numeric IDs.
    local args, count = { ... }, select('#', ...)
    for i = 1, count do
        local value = args[i]
        if addon.Platform and addon.Platform.CanReadValue and not addon.Platform:CanReadValue(value) then
            return func(...)
        end
        if type(value) == 'number' and value ~= value then return func(...) end
        if value == nil then args[i] = nilArgument end
    end
    local node = cache[func]
    for i = 1, count do
        if not node then break end
        node = node[args[i]]
    end
    local result = node and node[cachedResult]
    if result then
        cacheHits = cacheHits + 1
        return unpack(result, 1, result.n)
    end

    cacheMisses = cacheMisses + 1
    result = packResults(func(...))
    local store = recordnil
    if not store then
        -- Inspect the packed keys, not potentially restricted return values.
        for key in pairs(result) do
            if type(key) == 'number' then store = true; break end
        end
    end
    if store then
        -- Retry misses and thrown calls must not accumulate empty paths.
        if not cache[func] then cache[func] = {} end
        node = cache[func]
        for i = 1, count do
            local key = args[i]
            if not node[key] then node[key] = {} end
            node = node[key]
        end
        node[cachedResult] = result
    end
    return unpack(result, 1, result.n)

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