WoW:API UnitStat: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
({{wowapi}}, format) |
||
| Line 1: | Line 1: | ||
{{wowapi}} __NOTOC__ | |||
Returns info about one of the unit's stats (strength, agility, stamina, intellect, spirit). | |||
base, stat, posBuff, negBuff = UnitStat("unit", statID); | base, stat, posBuff, negBuff = UnitStat("unit", statID); | ||
==Parameters== | |||
===Arguments=== | |||
:;unit : String - The [[API TYPE UnitId|UnitId]] to get information from. (Only works for <tt>"player"</tt> and <tt>"pet"</tt>. Will work on <tt>"target"</tt> as long as it is equal to <tt>"player"</tt>) | :;unit : String - The [[API TYPE UnitId|UnitId]] to get information from. (Only works for <tt>"player"</tt> and <tt>"pet"</tt>. Will work on <tt>"target"</tt> as long as it is equal to <tt>"player"</tt>) | ||
:;statID : Number - An internal id corresponding to one of the stats. | |||
:;statID : Number - An internal id corresponding to one of the stats. | ::#Strength | ||
::#Agility | |||
::#Stamina | |||
::#Intellect | |||
::#Spirit | |||
===Return=== | |||
:base, stat, posBuff, negBuff | :base, stat, posBuff, negBuff | ||
:;base : Number - The unit's base stat. | :;base : Number - The unit's base stat. | ||
| Line 21: | Line 19: | ||
:;negBuff : Number - Any negative buffs applied to the stat. | :;negBuff : Number - Any negative buffs applied to the stat. | ||
==Example== | |||
local base, stat, posBuff, negBuff = UnitStat("player",1); | local base, stat, posBuff, negBuff = UnitStat("player",1); | ||
DEFAULT_CHAT_FRAME:AddMessage("Your current Strength is "..stat); | DEFAULT_CHAT_FRAME:AddMessage("Your current Strength is ".. stat); | ||
===Result=== | |||
A chat message stating your current strength is displayed | |||
Revision as of 00:26, 24 December 2006
Returns info about one of the unit's stats (strength, agility, stamina, intellect, spirit).
base, stat, posBuff, negBuff = UnitStat("unit", statID);
Parameters
Arguments
- unit
- String - The UnitId to get information from. (Only works for "player" and "pet". Will work on "target" as long as it is equal to "player")
- statID
- Number - An internal id corresponding to one of the stats.
- Strength
- Agility
- Stamina
- Intellect
- Spirit
Return
- base, stat, posBuff, negBuff
- base
- Number - The unit's base stat.
- stat
- Number - The unit's current stat.
- posBuff
- Number - Any positive buffs applied to the stat.
- negBuff
- Number - Any negative buffs applied to the stat.
Example
local base, stat, posBuff, negBuff = UnitStat("player",1);
DEFAULT_CHAT_FRAME:AddMessage("Your current Strength is ".. stat);
Result
A chat message stating your current strength is displayed