WoW:API UnitCanAttack: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
mNo edit summary
m (Move page script moved page API UnitCanAttack to API UnitCanAttack without leaving a redirect)
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
<center>'''UnitCanAttack''' ''-Documentation by [[user:danboo|danboo]]-''</center>
{{wowapi}} __NOTOC__
 
Returns 1 if the first unit can attack the second, nil otherwise.
Returns 1 if the first unit can attack the second, nil otherwise.


  UnitCanAttack(attacker, attacked);
  canAttack = UnitCanAttack(attacker, attacked);
 
----
;''Arguments''
 
:(String attacker, Table attacked)
 
:;attacker : the unit that would initiate the attack (e.g., "player" or "target")
:;attacked : the unit that would be attacked (e.g., "player" or "target")
 
----
;''Returns''
 
:1 if the <tt>attacker</tt> can attack the <tt>attacked</tt>, nil otherwise
 
----
;''Example''
  if ( UnitCanAttack("target", "player") ) then
    -- Hostile players are red
    if ( UnitCanAttack("player", "target") ) then
      TargetFrameNameBackground:SetVertexColor(1.0, 0.0, 0.0);
    end
  end
 
;''Result''
:If the target can attack the player and the player can attack the target then the target's name will appear red to the player.


----
==Parameters==
;''Description''
===Arguments===
:;attacker : [[UnitId]] - the unit that would initiate the attack (e.g., "player" or "target")
:;attacked : [[UnitId]] - the unit that would be attacked (e.g., "player" or "target")
===Returns===
:;canAttack : Bool - 1 if the ''attacker'' can attack the ''attacked'', nil otherwise.


: Returns 1 if the first unit can attack the second, nil otherwise.
==Example==
if ( UnitCanAttack("player", "target") ) then
  DEFAULT_CHAT_FRAME:AddMessage("You can attack " .. UnitName("target") .. ".");
end


----
===Result===
{{WoW API}}
If the player can attack their target, a message stating so is displayed in the default chat frame.

Latest revision as of 04:47, 15 August 2023

← WoW API < UnitCanAttack

Returns 1 if the first unit can attack the second, nil otherwise. 

canAttack = UnitCanAttack(attacker, attacked);

Parameters[edit]

Arguments[edit]

attacker
UnitId - the unit that would initiate the attack (e.g., "player" or "target")
attacked
UnitId - the unit that would be attacked (e.g., "player" or "target")

Returns[edit]

canAttack
Bool - 1 if the attacker can attack the attacked, nil otherwise.

Example[edit]

if ( UnitCanAttack("player", "target") ) then
 DEFAULT_CHAT_FRAME:AddMessage("You can attack " .. UnitName("target") .. ".");
end

Result[edit]

If the player can attack their target, a message stating so is displayed in the default chat frame.

Retrieved from "https://addonstudio.org/mw/index.php?title=WoW:API_UnitCanAttack&oldid=20037"