C_FriendList.SendWho

Main Menu
WoW API Lua API FrameXML util Widget API Widget scripts XML schema Events CVars Macro commands Combat Log Escape sequences Hyperlinks API changes HOWTOs wowuidev

Requests a list of other online players.

C_FriendList.SendWho(filter)

Arguments

filter

string - The criteria for which you want to perform a Who query. This can be anything for which you could normally search in a Who query:

• Any string, which will be matched against players' names, guild names, zones and levels.
• Name (n-"<char_name>")
• Zone (z-"<zone_name>")
• Race (r-"<race_name>")
• Class (c-"<class_name>")
• Guild (g-"<guild_name>")
• Level ranges: (<lower_limit>-<higher_limit>)

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. Double quotation marks are required, as single quotation marks won't work.

Details

• Fires WHO_LIST_UPDATE when the requested query has been processed. Note that there is a server-side cooldown; queries are not guaranteed to generate a response.

Example

Searches for players in the level 20 to 40 range.

C_FriendList.SendWho("20-40")

Searches for Night Elf Rogues in Teldrassil, of levels 10-15, with the string "bob" in their (guild) names.

C_FriendList.SendWho('bob z-"Teldrassil" r-"Night Elf" c-"Rogue" 10-15')

Patch changes

Patch 8.2.5 (2019-09-24): (+ Patch 1.13.2) Requires a hardware event as a measure against gold spam channel invites and other unintended uses for automatically querying player names.
Patch 8.1.0 (2018-12-11): Moved to C_FriendList.SendWho()
Patch 1.0.0 (2004-10-08): Added as SendWho()

See also

• C_FriendList.GetWhoInfo()
• C_FriendList.SetWhoToUi()