~ubuntu-branches/ubuntu/hoary/scilab/hoary

« back to all changes in this revision

Viewing changes to man/programming/lasterror.man

  • Committer: Bazaar Package Importer
  • Author(s): Torsten Werner
  • Date: 2005-01-09 22:58:21 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20050109225821-473xr8vhgugxxx5j
Tags: 3.0-12
changed configure.in to build scilab's own malloc.o, closes: #255869

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.TH lasterror 1 "April 2000" "Scilab Group" "Scilab Function"
2
 
.so ../sci.an
3
 
.SH NAME
4
 
lasterror - get last recorded error message
5
 
.SH CALLING SEQUENCE
6
 
.nf
7
 
str=lasterror( [opt] )
8
 
[str,n]=lasterror([opt])
9
 
.fi
10
 
.SH PARAMETERS
11
 
.TP 10
12
 
str 
13
 
: vector of character strings or an empty matrix. The last
14
 
recorded error message.
15
 
.TP
16
 
17
 
: integer, 0 or the last recorded error number.
18
 
.TP
19
 
opt
20
 
: boolean, if %t recorded message is cleared. Default is %t.
21
 
.SH DESCRIPTION
22
 
Each time an error occur, the Scilab error handler records it in
23
 
internal tables (only the last one is retained). The \fVlasterror\fR
24
 
function allows to get the message and the error number out of these
25
 
tables.
26
 
.LP
27
 
This function is useful while using \fVerrcatch\fR or \fVexecstr\fR.
28
 
.LP
29
 
The recorded error message may be retained for a further call to
30
 
\fVlasterror\fR using \fVlasterror(%f)\fR.
31
 
.SH EXAMPLE
32
 
.nf
33
 
ierr=execstr('a=zzzzzzz','errcatch')
34
 
if ierr>0 then disp(lasterror()),end
35
 
.fi 
36
 
.SH SEE ALSO
37
 
errcatch, execstr, error, errclear
38