Difference between revisions of "ON ERROR"
From Lianjapedia
Yvonne.milne (Talk | contribs) m (1 revision) |
Yvonne.milne (Talk | contribs) |
||
Line 1: | Line 1: | ||
==Purpose== | ==Purpose== | ||
Trap program errors | Trap program errors | ||
− | |||
==Syntax== | ==Syntax== | ||
ON ERROR [<command>] | ON ERROR [<command>] | ||
− | |||
==See Also== | ==See Also== | ||
[[DOSERROR()]], [[DISPLAY CALLS]], [[ERRNO()]], [[ERROR()]], [[LIST CALLS]], [[MESSAGE()]], [[ON ESCAPE]], [[ON KEY]], [[PROCLINE()]], [[PROCNAME()]], [[RETRY]], [[SET ONERROR]], [[STRERROR()]] | [[DOSERROR()]], [[DISPLAY CALLS]], [[ERRNO()]], [[ERROR()]], [[LIST CALLS]], [[MESSAGE()]], [[ON ESCAPE]], [[ON KEY]], [[PROCLINE()]], [[PROCNAME()]], [[RETRY]], [[SET ONERROR]], [[STRERROR()]] | ||
− | |||
==Description== | ==Description== | ||
− | The ON ERROR command causes the specified <command> to be executed if an error is encountered in a program. If ON ERROR is specified without a <command>, then the default | + | The ON ERROR command causes the specified <command> to be executed if an error is encountered in a program. If ON ERROR is specified without a <command>, then the default Lianja behavior will be restored. |
====<command>==== | ====<command>==== | ||
− | The <command> can be any | + | The <command> can be any Lianja command. After an error is encountered, the ERROR() function will return the error number, and the MESSAGE() function will return the error message. Specifying an '*' as the command causes any errors to be ignored, so should be used with caution. |
− | + | ||
==Example== | ==Example== | ||
Line 29: | Line 25: | ||
</code> | </code> | ||
− | |||
− | |||
− | |||
[[Category:Documentation]] | [[Category:Documentation]] | ||
[[Category:Commands]] | [[Category:Commands]] | ||
[[Category:Error Handling and Debugging]] | [[Category:Error Handling and Debugging]] | ||
[[Category:Error Handling and Debugging Commands]] | [[Category:Error Handling and Debugging Commands]] |
Revision as of 11:57, 10 December 2012
Purpose
Trap program errors
Syntax
ON ERROR [<command>]
See Also
DOSERROR(), DISPLAY CALLS, ERRNO(), ERROR(), LIST CALLS, MESSAGE(), ON ESCAPE, ON KEY, PROCLINE(), PROCNAME(), RETRY, SET ONERROR, STRERROR()
Description
The ON ERROR command causes the specified <command> to be executed if an error is encountered in a program. If ON ERROR is specified without a <command>, then the default Lianja behavior will be restored.
<command>
The <command> can be any Lianja command. After an error is encountered, the ERROR() function will return the error number, and the MESSAGE() function will return the error message. Specifying an '*' as the command causes any errors to be ignored, so should be used with caution.
Example
procedure badfile on error set message to "File does not exist." return to master on error do badfile use patrons