WoW API: User defined functions
Jump to navigation
Jump to search
← 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
Cursor Functions
- GetCursorScaledPosition() - Return the exact position the cursor is at based on scale.
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
Slash Function
- RunSlashCmd - Passes a slash command to the chatframe
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