1
1
<?xml version="1.0" encoding="UTF-8"?>
2
2
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns3="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" version="5.0-subset Scilab" xml:id="lasterror" xml:lang="en">
4
<refname>lasterror</refname>
5
<refpurpose>retorna a última mensagem de erro registrada</refpurpose>
8
<title>Seqüência de Chamamento</title>
9
<synopsis>str=lasterror( [opt] )
10
[str,n]=lasterror([opt])
11
[str,n,line,func]=lasterror([opt])
15
<title>Parâmetros</title>
20
<para>vetor de strings ou matriz vazia: a última mensagem de erro
28
<para>inteiro, 0 ou o último número de erro registrado</para>
34
<para>inteiro, 0 ou o último número de linha da função registrado
41
<para>string, o último nome da função registrado </para>
47
<para>booleano, se %t for registrado, a mensagem é limpa. O padrão é
55
<title>Descrição</title>
56
<para>Cada vez que um erro ocorre, o manipulador de erros do Scilab o
57
registra em tabelas ("tables") internas (apenas o último erro é retido). A
58
função <literal>lasterror</literal> permite obter a mensagem de erro, o
59
número de erro, a função corrente (se houver) e a linha corrente da função
60
corrente destas tabelas.
62
<para>O número de linha reportado é o número da linha
63
<emphasis>física</emphasis> onde o último erro ocorreu. Note que versões
64
Scilab anteriores à 5.0 reportavam o número da linha
65
<emphasis>lógica</emphasis> do último erro. A diferença realmente importa
66
apenas se a função em erro inclui linhas continuadas antes do ponto onde o
69
<para>Esta função é útil quando usada em conjunto com
70
<literal>errcatch</literal> ou <literal>execstr</literal>.
72
<para>A mensagem de erro pode ser retida para uma futura chamada a
73
<literal>lasterror</literal> usando
74
<literal>lasterror(%f)</literal>.
78
<title>Exemplos</title>
79
<programlisting role="example"><![CDATA[
4
<refname>lasterror</refname>
5
<refpurpose>retorna a última mensagem de erro registrada</refpurpose>
8
<title>Seqüência de Chamamento</title>
9
<synopsis>str=lasterror( [opt] )
10
[str,n]=lasterror([opt])
11
[str,n,line,func]=lasterror([opt])
15
<title>Parâmetros</title>
20
<para>vetor de strings ou matriz vazia: a última mensagem de erro
28
<para>inteiro, 0 ou o último número de erro registrado</para>
34
<para>inteiro, 0 ou o último número de linha da função registrado
41
<para>string, o último nome da função registrado </para>
47
<para>booleano, se %t for registrado, a mensagem é limpa. O padrão é
55
<title>Descrição</title>
56
<para>Cada vez que um erro ocorre, o manipulador de erros do Scilab o
57
registra em tabelas ("tables") internas (apenas o último erro é retido). A
58
função <literal>lasterror</literal> permite obter a mensagem de erro, o
59
número de erro, a função corrente (se houver) e a linha corrente da função
60
corrente destas tabelas.
62
<para>O número de linha reportado é o número da linha
63
<emphasis>física</emphasis> onde o último erro ocorreu. Note que versões
64
Scilab anteriores à 5.0 reportavam o número da linha
65
<emphasis>lógica</emphasis> do último erro. A diferença realmente importa
66
apenas se a função em erro inclui linhas continuadas antes do ponto onde o
69
<para>Esta função é útil quando usada em conjunto com
70
<literal>errcatch</literal> ou <literal>execstr</literal>.
72
<para>A mensagem de erro pode ser retida para uma futura chamada a
73
<literal>lasterror</literal> usando
74
<literal>lasterror(%f)</literal>.
78
<title>Exemplos</title>
79
<programlisting role="example"><![CDATA[
80
80
ierr=execstr('a=zzzzzzz','errcatch')
81
81
if ierr>0 then disp(lasterror()),end
82
82
]]></programlisting>
85
<title>Ver Também</title>
86
<simplelist type="inline">
88
<link linkend="errcatch">errcatch</link>
91
<link linkend="execstr">execstr</link>
94
<link linkend="error">error</link>
97
<link linkend="errclear">errclear</link>
100
<link linkend="edit_error">edit_error</link>
85
<title>Ver Também</title>
86
<simplelist type="inline">
88
<link linkend="errcatch">errcatch</link>
91
<link linkend="execstr">execstr</link>
94
<link linkend="error">error</link>
97
<link linkend="errclear">errclear</link>
100
<link linkend="edit_error">edit_error</link>