WoW:API UnitHealthMax - Revision history

Move page script: Move page script moved page API UnitHealthMax to WoW:API UnitHealthMax without leaving a redirect

2023-08-15T04:47:45Z

Move page script moved page API UnitHealthMax to API UnitHealthMax without leaving a redirect

← Older revision	Revision as of 04:47, 15 August 2023
(No difference)

WoWWiki>Egingell: Updated with new information: This function returns the actual max health of any unit.

2009-01-14T07:30:46Z

Updated with new information: This function returns the actual max health of any unit.

← Older revision		Revision as of 07:30, 14 January 2009
Line 13:		Line 13:
	Print the maximum health of ''player'' and ''target'' units to the chat window:		Print the maximum health of ''player'' and ''target'' units to the chat window:
	ChatFrame1:AddMessage('Player max health: ' .. UnitHealthMax("player") .. " HP");		ChatFrame1:AddMessage('Player max health: ' .. UnitHealthMax("player") .. " HP");
	ChatFrame1:AddMessage('Target max health: ' .. UnitHealthMax("target").. "%");		ChatFrame1:AddMessage('Target max health: ' .. UnitHealthMax("target") .. " HP");

WoWWiki>WoWWiki-Shefki: Factual correction

2009-01-13T07:24:06Z

Factual correction

← Older revision		Revision as of 07:24, 13 January 2009
Line 1:		Line 1:
	{{wowapi}} __NOTOC__		{{wowapi}} __NOTOC__
	Returns the maximum health of the specified unit~~. Returns the exact hitpoints for friendly players and pets in your raid/party, percentages otherwise~~.		Returns the maximum health of the specified unit.

	local max_health = UnitHealthMax(unit);		local max_health = UnitHealthMax(unit);

WoWWiki>Skeeve2: added note about 0 return for non exist unit

2007-10-12T12:33:36Z

added note about 0 return for non exist unit

← Older revision		Revision as of 12:33, 12 October 2007
Line 5:		Line 5:

	==Parameters==		==Parameters==
	~~===Arguments===~~
	:;unit : [[UnitId]] - the unit whose max health to query.		:;unit : [[UnitId]] - the unit whose max health to query.
	===Returns===
	:;max_health : Integer - the maximum health of the specified unit		==Returns==
			:;max_health : Integer - the maximum health of the specified unit, returns 0 if the specified unit does not exist (eg. "target" given but there is no target)

	==Example==		==Example==
			Print the maximum health of ''player'' and ''target'' units to the chat window:
	ChatFrame1:AddMessage('Player max health: ' .. UnitHealthMax("player") .. " HP");		ChatFrame1:AddMessage('Player max health: ' .. UnitHealthMax("player") .. " HP");
	ChatFrame1:AddMessage('Target max health: ' .. UnitHealthMax("target").. "%");		ChatFrame1:AddMessage('Target max health: ' .. UnitHealthMax("target").. "%");

	~~===Result===~~
	~~Prints the maximum health of ''player'' and ''target'' units to the chat window.~~

WoWWiki>Starlightblunder: {{wowapi}}, update

2006-12-23T16:19:53Z

{{wowapi}}, update

← Older revision		Revision as of 16:19, 23 December 2006
Line 1:		Line 1:
	~~<center>'''UnitHealthMax''' ''-Documentation by [[User:Danboo\|danboo]]-''</center>~~		{{wowapi}} __NOTOC__
			Returns the maximum health of the specified unit. Returns the exact hitpoints for friendly players and pets in your raid/party, percentages otherwise.
	Returns the ~~maximal~~ health of the specified unit, in ~~percentage~~, ~~for:~~

	*target
	*mouseover
	*pet if pet is charmed/enslaved

	~~Otherwise in points~~.

	local max_health = UnitHealthMax(unit);		local max_health = UnitHealthMax(unit);

	~~----~~		==Parameters==
	~~;''~~Arguments''		===Arguments===
			:;unit : [[UnitId]] - the unit whose max health to query.
	:~~(String~~ unit)		===Returns===
			:;max_health : Integer - the maximum health of the specified unit
	~~:;arg1~~ : the unit's max health to query

	~~----~~
	~~;''~~Returns''

	~~:max_health~~
	:;max_health : the maximum health of the specified unit

	~~----~~
	~~;''Example''~~
	~~local max_health = UnitHealthMax("player");~~
	~~local max_health2 = UnitHealthMax("target");~~
	~~ChatFrame1:AddMessage('player max health: ' .. max_health);~~
	~~ChatFrame1:AddMessage('target max health: ' .. max_health2 .. "%");~~

	~~;''Result''~~
	~~Prints the player's maximum health to the chat frame as~~

	~~'player max health: 900' and 'target max health: 100%'~~

	~~----~~
	~~;''Description''~~

	: Returns the maximum health of the specified unit. The health is returned in real points only if the unit is in the player's party. Otherwise, a percentage is returned (which will always be 100 in this case). (Note, that the player, the player's pet, and any party member pets are considered to be in the party.)		==Example==

			ChatFrame1:AddMessage('Player max health: ' .. UnitHealthMax("player") .. " HP");
			ChatFrame1:AddMessage('Target max health: ' .. UnitHealthMax("target").. "%");

	~~----~~		===Result===
	~~{{WoW API}}~~		Prints the maximum health of ''player'' and ''target'' units to the chat window.

WoWWiki>Muert at 05:33, 4 January 2006

2006-01-04T05:33:49Z

← Older revision		Revision as of 05:33, 4 January 2006
Line 40:		Line 40:

	: Returns the maximum health of the specified unit. The health is returned in real points only if the unit is in the player's party. Otherwise, a percentage is returned (which will always be 100 in this case). (Note, that the player, the player's pet, and any party member pets are considered to be in the party.)		: Returns the maximum health of the specified unit. The health is returned in real points only if the unit is in the player's party. Otherwise, a percentage is returned (which will always be 100 in this case). (Note, that the player, the player's pet, and any party member pets are considered to be in the party.)


	----		----
	{{~~Template:~~WoW API}}		{{WoW API}}
	~~[[Category:API Functions\|UnitHealthMax]]~~
	~~[[Category:API Unit Functions\|UnitHealthMax]]~~

WoWWiki>WoWWiki-Mord at 23:51, 29 September 2005

2005-09-29T23:51:40Z

← Older revision		Revision as of 23:51, 29 September 2005
Line 5:		Line 5:
	*target		*target
	*mouseover		*mouseover
			*pet if pet is charmed/enslaved

	Otherwise in points.		Otherwise in points.

WoWWiki>Jonhogg at 14:08, 29 September 2005

2005-09-29T14:08:16Z

← Older revision		Revision as of 14:08, 29 September 2005
Line 25:		Line 25:
	----		----
	;''Example''		;''Example''
	local max_health = ~~UnitHealth~~("player");		local max_health = UnitHealthMax("player");
	local max_health2 = ~~UnitHealth~~("target");		local max_health2 = UnitHealthMax("target");
	ChatFrame1:AddMessage('player max health: ' .. max_health);		ChatFrame1:AddMessage('player max health: ' .. max_health);
	ChatFrame1:AddMessage('target max health: ' .. max_health2 .. "%");		ChatFrame1:AddMessage('target max health: ' .. max_health2 .. "%");
Line 33:		Line 33:
	Prints the player's maximum health to the chat frame as		Prints the player's maximum health to the chat frame as

	'player max health: 900' and '~~taget~~ max health: 100%'		'player max health: 900' and 'target max health: 100%'

	----		----

WoWWiki>Inglais at 13:22, 27 August 2005

2005-08-27T13:22:48Z

← Older revision		Revision as of 13:22, 27 August 2005
Line 42:		Line 42:
	----		----
	{{Template:WoW API}}		{{Template:WoW API}}
			[[Category:API Functions\|UnitHealthMax]]
			[[Category:API Unit Functions\|UnitHealthMax]]

WoWWiki>WoWWiki-Bam: Clarified when a percentage is returned and when real health points are returned

2005-07-11T18:46:34Z

Clarified when a percentage is returned and when real health points are returned

← Older revision		Revision as of 18:46, 11 July 2005
Line 38:		Line 38:
	;''Description''		;''Description''

	: Returns the ~~maximal~~ health of the specified unit, in ~~percentage~~, ~~for:~~		: Returns the maximum health of the specified unit. The health is returned in real points only if the unit is in the player's party. Otherwise, a percentage is returned (which will always be 100 in this case). (Note, that the player, the player's pet, and any party member pets are considered to be in the party.)

	*target
	*mouseover

	~~Otherwise~~ in ~~points~~.

	----		----
	{{Template:WoW API}}		{{Template:WoW API}}