WoW:User defined functions

Reference e
AddOns WoW API Widget API XML UI Event API WoW Lua Macro API CVars Battle.net HOWTOs Snippets UI tech Categories

→ WoW API

← WoW API

These are cut-and-paste functions that you can use in your addons, submitted by WoWWiki contributors.

API

The following functions aim at extending the information WoW API provides; some are provided by specialized addons rather than being copy/pastable.

GetPlayerBearing() - Returns the player's current facing bearing.

GetSellValue(item) - Returns an item's merchant sell price.

Arguments & Returns

setArgs(myTable, "name", ...) - remember list of arguments to use for a callback

getArgs(myTable, "name", ...) - retreive stored list of arguments, plus optional extras

GetReturnValues(order, functionCall) - Get the return values from functionCall in any order you want.

Color Functions

ColorGradient(perc, R1, G1, B1, R2, G2, B2[, ...]) - Converts a percent value into a gradient from 2 or more RGB values

HexToRGB("string") - Converts a hex color string to RGB values (0-255)

HexToRGBPerc("string") - Converts a hex color string to RGB values (0.0-1.0)

RGBToHex(red, green, blue) - Converts a RGB value (0-255) into a hex string

RGBPercToHex(red, green, blue) - Converts a RGB value (0.0-1.0) into a hex string

Frame Functions

GetQuadrant(frame) - Find which quadrant of the screen a frame lies in.

GetUIParentAnchor(frame) - Returns SetPoint args for the frame, anchor is relative to the nearest corner of the screen.

Frame:SetManyAttributes(...) - Simple function to embed in a frame to set many atributes at once.

Item Functions

EquipItemByLink(link) - Equips the first matching item found in the player's bags.

Localization Tables

LocalizedClassNames - Table of localized classes

Metatables

Memorizing table - A special table that calculates values as needed and saves them into itself

String Functions

ChunkSplit(string [, length [, endChars]])   - Split a string into groups of "length" each ending with "endChars" (identical to the PHP function of the same name).

CountChars(haystack, needle)   - Return how many times needle is contained in haystack.

GetWords("string")   - Split words on space boundary, return table

printMSG("string")   - Displays a custom message to the default chat frame, for the user to see (time, code and size saver).

strfindt(tabCaptures, ...)   - Wrapper for strfind() that returns captures in a table - can be used in if() clauses!

StringHash("string")   - Create a fair-quality 32-bit hash of a string

substr("string", start [, length])   - Imp strsub. Returns a string starting from start to length characters from start (identical to the PHP function of the same name).

Table Functions

EraseTable(t) - Erase all values from a table

tinsertbeforeval(tab, valBefore, val)   - Insert one value before another (without knowing its index)

tremovebyval(tab, val)   - Remove a value (without knowing its index)

tcount(tab)   - Count table members (works on non-integer-indexed tables)

tcopy(tabTo, tabFrom)   - Recursively copy contents of one table to another

Time Functions

GameTime:Get()   - Get server time including seconds and milliseconds

See also

• Category:HOWTOs - must have cut-and-pasteable code snippets