Conditions.weapon.swingSpeed

Appel

Conditions.weapon.swingSpeed(value, cache)

Enregistrez la dépendance Conditions.weapon.swingSpeed, puis appelez-la sous ce nom. Un appel par espace de noms ne transmet pas self : utilisez un appel avec deux-points ou passez l'objet vous-même.

Ce qu'elle fait

Reads the player's main-hand, or off-hand when value.offhand is set, attack speed from the cached UnitAttackSpeed for the swing timer conditions. An off-hand check with no off-hand speed returns false.

Arguments

Nom	Type	Ce qu'elle fait
`value`	`table`	Condition settings; a truthy offhand field selects the off hand.
`cache`	`table \| nil`	Evaluation-pass cache passed to getCached, or nil to read directly.

Retours

1	`number \| boolean \| nil`	Swing speed in seconds, false when there is no off-hand weapon, or nil when unavailable.
2	`string \| nil`	Reason for nil: missing-api, api-error, restricted-value or invalid-weapon-observation.

Éditions

Les fonctions utilitaires intégrées sont enregistrées sur toutes les éditions. Ce qui diffère, c'est l'API du jeu qu'elles lisent ; quand l'une manque, la fonction utilitaire se rabat sur une alternative ou renvoie nil avec une raison.

Indisponible sur cette édition (la raison figure dans l'infobulle)
Uniquement tant que les solutions de repli de Blizzard pour les fonctions obsolètes sont actives

API du jeu
`UnitAttackSpeed`
`UnitRangedDamage`

Comment l'addon l'appelle

Délai de frappe de l'arme (evaluate)

local speed,reason=swingSpeed(value,cache)

Délai de frappe restant de l'arme (evaluate)
```
local speed,reason=swingSpeed(value,cache)
```

Dépendances

Functions.cache.getCached → Functions.cache.getCached
Functions.presentation.compareString → Functions.presentation.compareString
Functions.presentation.nullable → Functions.presentation.nullable
Functions.values.compare → Functions.values.compare
Functions.values.isin → Functions.values.isin
numericObservation → Conditions.weapon.numericObservation

Source

Conditions/weapon.lua, ligne 96. En lecture seule dans le jeu ; Dupliquer crée une copie modifiable.

Conditions.weapon.swingSpeed(value, cache)

    -- Ranged: the Auto Shot or wand interval (UnitRangedDamage), false with no
    -- ranged attack; the melee hands read UnitAttackSpeed.
    if value.ranged then
        local speed,reason=Functions.cache.getCached(cache,addon.Platform.GetRangedSwingSpeed,addon.Platform)
        if speed==nil then return nil,reason end
        return speed
    end
    if type(UnitAttackSpeed)~="function" then return nil,"missing-api" end
    -- pcall forwards the mainhand and offhand speeds from the observation.
    ---@diagnostic disable-next-line: unbalanced-assignments
    local ok,main,off=pcall(addon.getCached,cache,UnitAttackSpeed,"player")
    if not ok then return nil,"api-error" end
    local speed=main
    if value.offhand then
        speed=off
        -- No off-hand weapon: the API returns no off-hand speed. That is a
        -- reading (nothing to swing), so off-hand checks are false.
        if speed==nil then return false end
    end
    return numericObservation(speed)

Retour à Référence des fonctions