Navigation menu
Personal tools
Not logged in
Talk
Contributions
Create account
Log in
Namespaces
WoW
Talk
English
Views
Read
Edit
History
More
Search
Navigation
Home
Random page
Help using wiki
Editions
for WoW
for WildStar
for Solar2D
Documentation
for WoW
for WildStar
Reference
WoW
⦁ FrameXML
⦁ AddOns
⦁ API
⦁ WoW Lua
WildStar
⦁ AddOns
⦁ API
⦁ WildStar Lua
Engine
Tools
What links here
Related changes
Special pages
Page information
Site
Recent Changes
Editing
WoW:API pcall
Jump to navigation
Jump to search
Warning:
You are not logged in. Your IP address will be publicly visible if you make any edits. If you
log in
or
create an account
, your edits will be attributed to your username, along with other benefits.
Anti-spam check. Do
not
fill this in!
{{wowlua}} Calls a function, returning a boolean indicating success as the first return value, and error text / return values as the following values. retOK, ret1, ret2, ... retn = pcall (func, arg1, arg2, ...); == Arguments == ;func : Function - The function that will be called (from within) pcall(). ;arg1 - argn : Variable - Any variable that is also to be passed with the function when its called (Optional). == Returns == ;retOK : Boolean - If the call to the function (that was passed to pcall) succeeded, returns true. If an error occured, returns false. ;ret1 : String (if failed) / Variable - If an error occured, error text is returned; if not, ret1 is the first return value of the original function. ;ret2 - retn : Variable - If the function call succeeded, those return variables contain values returned by original function. == Example == function myTest(incrementVal) return incrementVal + 10; end local retOK, ret1 = pcall(myTest,"string value"); local msg = ""; if (retOK) then msg = "Function succeeded, result: " .. ret1 .. "."; else msg = "Function failed, error text: " .. ret1 .. "."; end DEFAULT_CHAT_FRAME:AddMessage(msg); ====Result==== pcall will catch the error that occured within 'myTest', and output the appropriate text to the default chat window. If "string value" is replaced by a number, the code will output number+10 instead. ==Details== : pcall will ''also'' return other arguments returned from the "function" if all is successful.
Summary:
Please note that all contributions to AddOn Studio are considered to be released under the Creative Commons Attribution-NonCommercial-ShareAlike (see
AddOn Studio Wiki:Copyrights
for details).
Submissions must be written by you, or copied from a public domain or similar free resource (see
AddOn Studio Wiki:Copyrights
for details).
Cancel
Editing help
(opens in new window)
Templates used on this page:
Template:Apinav
(
edit
)
Template:Editlink
(
edit
)
Template:Wowlua
(
edit
)