User Guide
Quick Reference
Modding
Development
User Guide
Quick Reference
Modding
Development
Like in C++, the try and catch keywords are used to begin blocks of code where exceptions can be thrown and processed.
If an exception is thrown outside try/catch, it will be uncaught and execution of the script to be aborted.
try: print 'Nothing thrown yet.' catch: print 'Skipped.'
Exceptions are thrown using a throw statement.
throw can be used inside a catch compound to rethrow the caught exception.try
throw "There was an error"
catch
print 'Exception caught'
end
If the exception does not require any handling, one can use pass as the catch block.
try: throw 'Problem!' catch: pass
The exception message can be assigned to a local variable so it can be accessed in the catch block.
try: throw "OMG!"
catch Error, er
print 'Caught:', er
end
Output:
Caught: [Error] (in script) OMG!
Multiple catch blocks can be chained together to catch specific types of exceptions.
try
throw 'This will be printed'
catch NullError: print 'Got NullError'
catch Error, er: print er
catch: print 'Never here.'
Try/catch can be nested, and an exception thrown in an inner try block can be caught in an outer block.
try
try
try
throw 'Deep.'
catch BogusError
end
catch BogusError
end
try
catch Error, er
print 'Should *not* be caught here.'
end
catch Error, er
print 'Got it:', er
end
In this example, BogusError does not match the type of error thrown in scripts (a generic Error), so the catch blocks are skipped. The output is:
Got it: [Error] (in script) Deep.
An exception thrown in a function unwinds the call stack to find a matching catch block.
def erroneous()
throw "Dropped the ball"
end
try
print "Calling erroneous()"
erroneous()
try
print 'This will be skipped!'
catch
print 'I am on the wrong catch level.'
end
catch
print 'Fumbled it...'
end
Native code may throw various kinds of exceptions that can then be caught in the script. In the example below, a NullError gets thrown because the code tries to access a deleted object via an alias.
try
record temp
reference = temp
del temp
print reference
catch NullError, er
print 'Oh noes:', er
end
ReadOnlyError is thrown when trying to change a const variable.
const SOME_CONSTANT = 3.1415
try
SOME_CONSTANT = 3
catch ReadOnlyError, er
print 'Cannot do it.', er
end
try
const SOME_CONSTANT = 3
catch ReadOnlyError, er
print 'Will not work either:', er
end
Any type of native exception can be caught in a script.