Navigation menu

WoW:API GetQuestLogLeaderBoard: Difference between revisions

Jump to navigation Jump to search
m
Move page script moved page API GetQuestLogLeaderBoard to WoW:API GetQuestLogLeaderBoard without leaving a redirect
mNo edit summary
m (Move page script moved page API GetQuestLogLeaderBoard to WoW:API GetQuestLogLeaderBoard without leaving a redirect)
 
(11 intermediate revisions by 10 users not shown)
Line 1: Line 1:
{{wowapi}}
This function returns up to 3 values:
This function returns up to 3 values:


local title, type, done GetQuestLogLeaderBoard(i)
local desc, type, done = GetQuestLogLeaderBoard(i, [questID])


Where "i" is the index of the quests objectives (see GetNumQuestLeaderBoards ).
----
title is something like: "Kill foo: 0/3"
;''Arguments''
type could be the following things: "item" or "monster"
and done is nil if this sub objective is not completed yet, else it is 1


[[Category:API Functions|GetQuestLogLeaderBoard]]
:;i : Index of the quests objective (see [[API GetNumQuestLeaderBoards|GetNumQuestLeaderBoards()]] ).
[[Category:API Quest Functions|GetQuestLogLeaderBoard]]
 
:;questID : Identifier of the quest in the quest log. If not provided, default to the currently selected Quest, via [[API SelectQuestLogEntry|SelectQuestLogEntry()]].
 
----
;''Return values''
 
:;desc : String - The text description of the objective, like: "Kill foo: 0/3"
 
:;type : String - could be the following things: "item", "object", "monster", "reputation", "log", or "event".
 
:;done : Boolean - ''nil'' if this sub objective is not completed yet, else 1
 
----
;''Useful examples''
 
function GetLeaderBoardDetails (boardIndex,questIndex)
  local leaderboardTxt, itemType, isDone = GetQuestLogLeaderBoard (boardIndex,questIndex);
  local i, j, itemName, numItems, numNeeded = string.find(leaderboardTxt, "(.*):%s*([%d]+)%s*/%s*([%d]+)");
  return itemType, itemName, numItems, numNeeded, isDone;
end
-- returns eg. "monster", "Young Nightsaber slain", 1, 7, nil
 
----
;''Notes''
 
The type "player" was added in WotLK, which is used by {{questlong|Alliance|80|No Mercy!}} and probably other quests.
 
The type "log" was added sometime around patch 3.3.0, and seems to have replaced many instances of "event".
 
Only ever found one quest, {{quest|The Thandol Span (3)|The Thandol Span}} that had an "object" objective.
 
The "desc" returnvalue can be incomplete under some (unknown) circumstances containing an empty string or just says "slain" instead the real objective text.
Anonymous user