Dongle provides very basic debug and print utility functions to its objects. These come in a number of flavors, detailed below.

This API was introduced with Dongle-1.0

Contents 1 DongleObject:EnableDebug(level[, frame]) 1.1 Arguments 2 DongleObject:IsDebugEnabled() 2.1 Returns 3 DongleObject:Print(msg, ...) 3.1 Arguments 4 DongleObject:PrintF(msg, ...) 4.1 Arguments 5 DongleObject:Debug(level, ...) 5.1 Arguments 6 DongleObject:DebugF(level, msg, ...) 6.1 Arguments

DongleObject:EnableDebug(level[, frame])

Enables debugging for DongleObject at level, output being sent to frame.

Arguments

• level (number) - The debug level to enable. Any messages <= to this level will be displayed.
• frame (table) - The chat frame to send the output to. This can be any object with an "AddMessage" method, in all actuality.

DongleObject:IsDebugEnabled()

Returns

• debugLevel - The current debugLevel of the DongleObject or nil.
• debugFrame - The current debugFrame of the DongleObject or nil.

DongleObject:Print(msg, ...)

Sends the message to the debug chat frame (or DEFAULT_CHAT_FRAME). If extra arguments are supplied, the arguments are all tostring()'d and concatenated together with comma separators.

Arguments

• msg (string, boolean, table, function, thread, userdata) - The object to print
• ... - Any amount of objects to be printed, including nil

DongleObject:PrintF(msg, ...)

Sends the formatted message to the debug chat frame (or DEFAULT_CHAT_FRAME). This function expects a format string, and potentially a number of arguments.

Arguments

• msg (string) - The string to pass to string.format()
• ... - The arguments to be passed to string.format()

DongleObject:Debug(level, ...)

Sends the debug message to the debug chat frame (or DEFAULT_CHAT_FRAME). If extra arguments are supplied, the arguments are all tostring()'d and concatenated together with comma separators. Message is only printed if level is <= the DongleObject's current debugLevel.

Arguments

• level (number) - The level of message to send
• ... - Any amount of objects to be printed, including nil

DongleObject:DebugF(level, msg, ...)

Sends the formatted debug message to the debug chat frame (or DEFAULT_CHAT_FRAME). This function expects a format string, and potentially a number of arguments. Message is only printed if level is <= the DongleObject's current debugLevel.

Arguments

• level (number) - The level of message to send
• msg (string) - The string to pass to string.format()
• ... - The arguments to be passed to string.format()