WoW:API UnitInRange: Difference between revisions
m (Move page script moved page API UnitInRange to API UnitInRange without leaving a redirect) |
|||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 2: | Line 2: | ||
<!-- Describe the purpose of the function, exhausting detail can be saved for a later section --> | <!-- Describe the purpose of the function, exhausting detail can be saved for a later section --> | ||
Returns 1 if the unit is in range (40yds) and | Returns 1 if the unit is in range of most helpful spells (40yds) and in a group / raid with you, otherwise nil. | ||
<!-- List return values and arguments as well as function name, follow Blizzard usage convention for args --> | <!-- List return values and arguments as well as function name, follow Blizzard usage convention for args --> | ||
| Line 9: | Line 9: | ||
== Arguments == | == Arguments == | ||
<!-- List each argument, together with its type --> | <!-- List each argument, together with its type --> | ||
;unit : String - [[unitId]] to check. | ;unit | ||
: String - [[unitId]] to check. | |||
== Returns == | == Returns == | ||
<!-- List each return value, together with its type --> | <!-- List each return value, together with its type --> | ||
;isTrue : 1 or nil | ;isTrue | ||
: 1 or nil | |||
== Example == | == Example == | ||
| Line 19: | Line 21: | ||
if UnitInRange("target") then | if UnitInRange("target") then | ||
print(UnitName("target") .. " is 40 yds away.") | print(UnitName("target") .. " is 40 yds away.") | ||
else | |||
print(UnitName("target") .. " is not in range!") | print(UnitName("target") .. " is not in range!") | ||
end | end | ||
Latest revision as of 04:47, 15 August 2023
← WoW API < UnitInRange
Returns 1 if the unit is in range of most helpful spells (40yds) and in a group / raid with you, otherwise nil.
isTrue = UnitInRange("unit")
Arguments
- unit
- String - unitId to check.
Returns
- isTrue
- 1 or nil
Example
if UnitInRange("target") then
print(UnitName("target") .. " is 40 yds away.")
else
print(UnitName("target") .. " is not in range!")
end
Result
FarfarawayDPS is 40 yds away. FarfarawayDPS is not in range!
Details
- Returns 'false' for any unit not in party or raid.
- Will return nil for hostile units.