checkError

Synopsis

$ checkError([$error])

Returns the last error message to occur.

$error - a scalar to place the last error object into. Often times this error object will be an instance of a java.lang.Exception.

The last error object. The same one placed into the $error parameter.

Clears the error condition so subsequent calls to &checkError will result in $null.
The value of the $error scalar is updated with the last error object. ala Perl's $!
This is but one error handling mechanism available, a more Java-style try/catch can be forced with debug level 34. This debug level will cause the error message to be thrown any time an error is flagged.
Debug level 2 will automatically print out a notification any time a checkError value is flagged.

$handle = openf(">/etc/shadow"); if (checkError($error)) { warn("Could not open the file: $error"); }

Warning: Could not open the file: java.io.FileNotFoundException: /etc/shadow (Permission denied) at checkError.sl:5