errcatch

errcatch — error trapping

Calling sequence

errcatch(n [,'action'] [,'option'])

`n`	: integer
`action, option`	: strings

errcatch gives an "action" (error-handler) to be performed when an error of type n occurs. n has the following meaning:

if n>0, n is the error number to trap

if n<0 all errors are to be trapped

action is one of the following character strings:

`"pause"`	: a pause is executed when trapping the error. This option is useful for debugging purposes. Use `whereami()` to get informations on the current context.
`"continue"`	: next instruction in the function or exec files is executed, current instruction is ignored. It is possible to check if an error has occured using the `iserror` function. Do not forget to clear the error using the `errclear` function as soon as possible This option is useful for error recovery. In many cases, usage of `errcatch(n,"continue",..)` can be replaced by the use of `execstr` function.
`"kill"`	: default mode, all intermediate functions are killed, scilab goes back to the level 0 prompt.
`"stop"`	: interrupts the current Scilab session (useful when Scilab is called from an external program).

option is the character string 'nomessage' for killing error message.

To set back default mode, enter errcatch(-1,"kill") or similarly errcatch(-1).

Then called in a scilab function the errcatch is automatically reset to the default mode when the function returns.

Use execstr(...,'errcatch') instead of errcatch when possible.