m
Move page script moved page API UnitName to WoW:API UnitName without leaving a redirect
m (Fixed result.) |
m (Move page script moved page API UnitName to WoW:API UnitName without leaving a redirect) |
||
| (12 intermediate revisions by 12 users not shown) | |||
| Line 1: | Line 1: | ||
{{wowapi}} __NOTOC__ | |||
<!-- Describe the purpose of the function, exhausting detail can be saved for a later section --> | |||
Returns the name and realm of the specified unit. | |||
== Arguments == | <!-- List return values and arguments as well as function name, follow Blizzard usage convention for args --> | ||
name, realm = UnitName("unit") | |||
== Parameters == | |||
=== Arguments === | |||
<!-- List each argument, together with its type --> | |||
:("unit") | :("unit") | ||
:;unit : String - The [[API TYPE UnitId|UnitId]] to query (e.g. "player", "party2", "pet", "target" etc.) | :;unit : String - The [[API TYPE UnitId|UnitId]] to query (e.g. "player", "party2", "pet", "target" etc.) | ||
== Returns == | === Returns === | ||
:name | <!-- List each return value, together with its type --> | ||
:;name | |||
:; | :: String - The name of the specified unit, "nil" if not applicable (e.g., if the specified unit is "target" but the player has no target selected). | ||
:;realm | |||
:: String - The realm the specified unit is from. For "player" returns nil, for any other character on your own realm returns an empty string. This is as of 1.12 | |||
== Example == | == Example == | ||
<!-- If it helps, include an example here, though it's not required if the usage is self-explanatory --> | |||
<!-- begin code --> | <!-- begin code --> | ||
local playerName = UnitName("player"); | local playerName = UnitName("player"); | ||
ChatFrame1:AddMessage('Hi my name is: ' .. playerName); | ChatFrame1:AddMessage('Hi my name is: ' .. playerName); | ||
<!-- end code --> | <!-- end code --> | ||
==== Result ==== | |||
====Result==== | |||
<!-- If it helps, include example results here, though they are not required. You're allowed to cheat liberally since WoW isn't a command line language. --> | |||
:Prints the player's name to the chat frame. e.g. | :Prints the player's name to the chat frame. e.g. | ||
<!-- begin code --> | <!-- begin code --> | ||
| Line 27: | Line 36: | ||
<!-- end code --> | <!-- end code --> | ||
---- | ==Details== | ||
<!-- Details not appropriate for the main description can go here. | |||
REMOVE the section if you're just going to restate the intro line! --> | |||
[[Category:API | |||
* UnitName("unit") (or any other unit) will return "Unknown Entity" (Actually the value of the UNKNOWNOBJECT global) if called before the unit in question has been fully loaded into the world. | |||
* The '''realm''' return will be nil even if the player is from a different realm, if it is out of visible range. | |||
* Realm name will not include server type | |||
* Note that this function always returns two values even though the latter may be nil. The difference is usually moot, but there are some cases where it matters, e.g. <span style="white-space: nowrap;"><tt>tinsert(myTable, UnitName("player"))</tt></span>, which would previously work, but will now cause errors. The fix is to put the expression in parenthesis: <span style="white-space: nowrap;" ><tt>tinsert(myTable, (UnitName("player")) )</tt></span>. | |||
* The default Blizzard UI defines [[API_GetUnitName|GetUnitName]](unit, showServerName) which only returns the unit name, but for characters from another server appends the server name (showServerName==true) or "(*)" (if showServerName==false). | |||
[[Category:World of Warcraft API]] | |||