Editing WoW:API SendWho (section)

{{wowapi}}

Sends a [[Who List|Who request]], much like using the [[Slash Command|slash command]] ''/who'' or entering a query in the entry field of the [[Who List]].

<pre>SendWho(filter)</pre>
----
'''''Arguments'''''
: (String filter)

: '''filter'''
:: The critera for which you want to perform a [[Who List#Who Query Entry Field|Who query]], surrounded by quotation marks.  This can be anything for which you could normally search in a Who query:

::* [[Name]] (minimum of 3 characters; string can appear anywhere in the name)
::* [[Name]] (''n-\"&lt;char_name&gt;\"'')
::* [[Zone]] (''z-\"&lt;zone_name&gt;\"'')
::* [[Race]] (''r-\"&lt;race_name&gt;\"'')
::* [[Class]] (''c-\"&lt;class_name&gt;\"'')
::* [[Guild]] (''g-\"&lt;guild_name&gt;\"'')
::* [[Level]] (''&lt;lower_limit&gt;-&lt;higher_limit&gt;'' or ''&lt;single_level&gt;'')

:: These can be combined, but no more than one of each type can be searched for at once.  Note that the quotation marks around the zone, race, and class must be present, and they must be escaped (\").

:: None of these are ''required''; you may send a blank query:

::: '''/script SendWho("");'''

:: This returns up to 50 apparently-random players, throughout the world, as if you had simply typed "/who" into the [[Chat|chat frame]].  (The quotation marks '''must''' be present, even if you are not submitting any criteria!)

----
'''''Returns'''''
: SendWho appears to always return ''nil''.

----
'''''Example'''''
<pre>SendWho('bob z-"Teldrassil" r-"Night Elf" c-"Rogue" 10-15');</pre>

'''''Result'''''
: Searches for Night Elf Rogues in Teldrassil, of levels 10-15, with the string "bob" in their names.