1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154
|
<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
* Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
* Copyright (C) XXXX-2008 - INRIA
*
* This file must be used under the terms of the CeCILL.
* This source file is licensed as described in the file COPYING, which
* you should have received as part of this distribution. The terms
* are also available at
* http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
*
-->
<refentry version="5.0-subset Scilab" xml:id="execstr" xml:lang="en"
xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:svg="http://www.w3.org/2000/svg"
xmlns:ns4="http://www.w3.org/1999/xhtml"
xmlns:mml="http://www.w3.org/1998/Math/MathML"
xmlns:db="http://docbook.org/ns/docbook">
<info>
<pubdate>$LastChangedDate$</pubdate>
</info>
<refnamediv>
<refname>execstr</refname>
<refpurpose>executa cdigo Scilab em strings</refpurpose>
</refnamediv>
<refsynopsisdiv>
<title>Seqncia de Chamamento</title>
<synopsis>execstr(instr)
ierr=execstr(instr,'errcatch' [,msg])</synopsis>
</refsynopsisdiv>
<refsection>
<title>Parmetros</title>
<variablelist>
<varlistentry>
<term>instr</term>
<listitem>
<para>vetor de strings, instruo Scilab a ser executada. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>ierr</term>
<listitem>
<para>inteiro, 0 ou nmero de erro. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>msg</term>
<listitem>
<para>string com valores <literal>'m'</literal> ou
<literal>'n'</literal>. O padro <literal>'n'</literal>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsection>
<refsection>
<title>Descrio</title>
<para>Executa as instrues Scilab fornecidas pelo argumento
<literal>instr</literal>.</para>
<para>Note que instr no deve fazer uso de marcas de continuao(..)
</para>
<para></para>
<para>Se o flag 'errcatch' no estiver presente, a manipulao de erros
ocorre de maneira usual.</para>
<para>Se o flag 'errcatch' for ajustado, e um erro for encontrado enquanto
so executadas as instrues definidas em <literal>instr</literal>,
<literal>execstr</literal> no imprime uma mensagem de erro, mas aborta a
execuo das instrues <literal>instr</literal> (no ponto onde o erro
ocorreu) e retorna com <literal>ierr</literal> igual ao nmero de erro.
Neste caso a exibio da mensagem de erro controlada pela opo
<literal>msg</literal> :</para>
<variablelist>
<varlistentry>
<term>"m"</term>
<listitem>
<para>a mensagem exibida e registrada.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>"n"</term>
<listitem>
<para>nenhuma mensagem de erro exibida, mas a mensagem de erro
registrada (ver <literal>lasterror</literal>). Este o
padro.</para>
</listitem>
</varlistentry>
</variablelist>
<para>ierr= execstr(instr,'errcatch') pode manipular erros sintticos.
Isto til para a avaliao de uma instruo obtida por uma pegunta ao
usurio.</para>
</refsection>
<refsection>
<title>Exemplos</title>
<programlisting role="example"><![CDATA[
execstr('a=1') // ajusta a=1.
execstr('1+1') // faz nada (enquanto evstr('1+1') retorna 2)
execstr(['if %t then';
' a=1';
' b=a+1';
'else'
' b=0'
'end'])
execstr('a=zzzzzzz','errcatch')
execstr('a=zzzzzzz','errcatch','m')
//erros de sintaxe
execstr('a=1?02','errcatch')
lasterror(%t)
execstr('a=[1 2 3)','errcatch')
lasterror(%t)
]]></programlisting>
</refsection>
<refsection>
<title>Ver Tambm</title>
<simplelist type="inline">
<member><link linkend="evstr">evstr</link></member>
<member><link linkend="lasterror">lasterror</link></member>
<member><link linkend="error">error</link></member>
<member><link linkend="try">try</link></member>
</simplelist>
</refsection>
</refentry>
|