WoW:API UnitHealth: Difference between revisions

Latest revision as of 04:47, 15 August 2023

Reference e
AddOns WoW API Widget API XML UI Event API WoW Lua Macro API CVars Battle.net HOWTOs Snippets UI tech Categories

Returns the current health of the specified unit.

local health = UnitHealth(unit);

health: Integer - current health of the specified unit, returns 0 if the specified unit does not exist (eg. "target" given but there is no target)

Print the target's health to the chat frame:

DEFAULT_CHAT_FRAME:AddMessage( "target health ="..UnitHealth("target") )

@@ Line 1: / Line 1: @@
- <center>'''UnitHealth''' ''-Documentation by [[User:Danboo|danboo]]-''</center>
+{{wowapi}} __NOTOC__
+Returns the current health of the specified unit.
-Returns the current health of the specified unit, in percentage, for:
-*target
-*mouseover
-Otherwise in points.
   local health = UnitHealth(unit);
-----
+==Parameters==
-;''Arguments''
+:;unit : [[UnitId]] - identifies the unit to query health for
-:(String unit)
-:;arg1 : the unit's health to query
-----
-;''Returns''
-:health
-:;health : the current health of the specified unit
-----
-;''Example''
- local health = UnitHealth("player");
- local health2 = UnitHealth("target");
- ChatFrame1:AddMessage('player health: ' .. health);
- ChatFrame1:AddMessage('target health: ' .. health .. "%");
-;''Result''
- Prints the player's and target's health to the chat frame as
- 'player health: 900' and 'target health: 80%'.
-----
-;''Description''
-: Returns the current health of the specified unit, in percentage, for:
-*target
-*mouseover
-Otherwise in points.
+==Returns==
+:;health : Integer - current health of the specified unit, returns 0 if the specified unit does not exist (eg. "target" given but there is no target)
-----
+==Example==
-{{Template:WoW API}}
+Print the target's health to the chat frame:
+ DEFAULT_CHAT_FRAME:AddMessage( "target health ="..UnitHealth("target") )