WoW:API CancelPlayerBuff: Difference between revisions

Revision as of 21:02, 10 December 2007

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

Removes a specific buff from the player.

CancelPlayerBuff(buffIndex);

buffIndex: The index of the buff to remove. Can be obtained with GetPlayerBuff. Can also use buff name since the 2.3 patch.

CancelPlayerBuff(GetPlayerBuff(0,"HELPFUL"))

Removes the first (right-most in the default UI) buff from the player.

This function is not protected nor limited in any way to hardware event restriction Blizzard used so far. This function can be called freely from an AddOn to auto-remove a given buff.

(tested on live servers 2.0)

This function uses a zero-based index, while UnitBuff() does not.
- The Burning Crusades: GetPlayerBuff() returns 0 if the buff doesn't exist. It stands to reason that this function would then be 1-based in TBC.

@@ Line 17: / Line 17: @@
 Removes the first (right-most in the default UI) buff from the player.
-;''Notes''
-this function uses a zero-based index, while UnitBuff() does not. [[User:Fsdfs|Mind]] 21:11, 19 July 2006 (EDT)
 ;''See Also''
@@ Line 28: / Line 23: @@
 ====Notes====
-* Surprisingly this function is not protected nor limited in any way to hardware event restriction Blizzard used so far. This function can be called freely from an AddOn to auto-remove a given buff.
+* This function is not protected nor limited in any way to hardware event restriction Blizzard used so far. This function can be called freely from an AddOn to auto-remove a given buff.
 (tested on live servers 2.0)
+* This function uses a zero-based index, while UnitBuff() does not.
+** '''The Burning Crusades:''' [[API GetPlayerBuff|GetPlayerBuff]]() returns ''0'' if the buff doesn't exist. It stands to reason that this function would then be 1-based in TBC.