# lasterror

get last recorded error message

## Calling Sequence

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

## Arguments

str

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

n

  an integer, 0 or the last recorded error number.

line

  an integer, 0 or the last recorded function line number.

func

  a string, the last recorded function name.

opt

  a 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