Name

lasterror — get last recorded error message

Calling Sequence

str=lasterror( [opt] )
[str,n]=lasterror([opt])
[str,n,line,func]=lasterror([opt])

Parameters

str

vector of character strings or an empty matrix. The last recorded error message.

n

integer, 0 or the last recorded error number.

line

integer, 0 or the last recorded function line number.

func

string, the last recorded function name

opt

boolean, if %t recorded message is cleared. Default is %t.

Description

Each time an error occurs, the Scilab error handler records it in an internal table (only the last one is retained). The lasterror function allows to get the message, the error number, the current function (if any) and the current line number in the current function out of this table.

The reported line number is the physical line number where the last error occurred. Note that Scilab versions before 5.0 used to report the logical line number of the last error. There is a difference only if the function in error includes continued lines (see dot) before the point where the error happened.

This function is especially useful while using errcatch or execstr.

The recorded error message may be retained for a further call to lasterror using lasterror(%f).

Examples

 
ierr=execstr('a=zzzzzzz','errcatch')
if ierr>0 then disp(lasterror()),end
 

See Also

errcatch, execstr, error, errclear, edit_error