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:ns5="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="exec" xml:lang="en">
4
<refname>exec</refname>
5
<refpurpose>execução de arquivo script ("script" significa
10
<title>Seqüência de Chamamento</title>
11
<synopsis>exec(path [,mode])
13
ierr=exec(path,'errcatch' [,mode])
14
ierr=exec(fun,'errcatch' [,mode])
18
<title>Parâmetros</title>
23
<para>string, o endereço do arquivo script </para>
29
<para>escalar inteiro, o modo de execução (ver abaixo) </para>
35
<para>uma função do Scilab </para>
41
<para>inteiro, 0 ou número de erro</para>
47
<title>Descrição</title>
49
<literal>exec(path [,mode])</literal> executa seqüencialmente as
50
instruções contidas no arquivo fornecido por <literal>path</literal> com
51
um modo de execução opcional <literal>mode</literal> .
54
Os casos diferentes para <literal>mode</literal> são :
56
<para>0 : o valor padrão</para>
57
<para>-1 : nada é impresso</para>
58
<para>1 : eco de cada linha de comando</para>
59
<para>2 : prompt --> é impresso</para>
60
<para>3 : ecos + prompts</para>
61
<para>4 : pára antes de cada prompt. A execução retorna após cada retorno
64
<para>7 : paradas + prompts + ecos : útil para demos.</para>
66
<literal>exec(fun [,mode])</literal> executa a função
67
<literal>fun</literal> como um script: sem argumentos de entrada ou saída
68
nem ambientes de variáveis específicos. Esta forma é mais eficiente,
69
porque o código script pode se pré-compilado (ver comp). Este método
70
para avaliação de scripts permite armazenar scripts como funções em
73
<para>Se um erro é encontrado durante a execução, se o flag 'errcatch'
74
estiver presente <literal>exec</literal> não imprime mensagem de erro,
75
aborta execução de instruções e retorna com <literal>ierr</literal> e
76
igual ao número de erro. Se o flag 'errcatch' não estiver presente, a
77
manipulação de erros padrão é utilizada.
81
<title>Observação </title>
82
<para>Arquivos executáveis (exec files) podem agora ser usados para
83
definir funções "inline" utilizando a sintaxe de definição (ver
4
<refname>exec</refname>
5
<refpurpose>execução de arquivo script ("script" significa
10
<title>Seqüência de Chamamento</title>
11
<synopsis>exec(path [,mode])
13
ierr=exec(path,'errcatch' [,mode])
14
ierr=exec(fun,'errcatch' [,mode])
18
<title>Parâmetros</title>
23
<para>string, o endereço do arquivo script </para>
29
<para>escalar inteiro, o modo de execução (ver abaixo) </para>
35
<para>uma função do Scilab </para>
41
<para>inteiro, 0 ou número de erro</para>
47
<title>Descrição</title>
49
<literal>exec(path [,mode])</literal> executa seqüencialmente as
50
instruções contidas no arquivo fornecido por <literal>path</literal> com
51
um modo de execução opcional <literal>mode</literal> .
54
Os casos diferentes para <literal>mode</literal> são :
56
<para>0 : o valor padrão</para>
57
<para>-1 : nada é impresso</para>
58
<para>1 : eco de cada linha de comando</para>
59
<para>2 : prompt --> é impresso</para>
60
<para>3 : ecos + prompts</para>
61
<para>4 : pára antes de cada prompt. A execução retorna após cada retorno
64
<para>7 : paradas + prompts + ecos : útil para demos.</para>
66
<literal>exec(fun [,mode])</literal> executa a função
67
<literal>fun</literal> como um script: sem argumentos de entrada ou saída
68
nem ambientes de variáveis específicos. Esta forma é mais eficiente,
69
porque o código script pode se pré-compilado (ver comp). Este método
70
para avaliação de scripts permite armazenar scripts como funções em
73
<para>Se um erro é encontrado durante a execução, se o flag 'errcatch'
74
estiver presente <literal>exec</literal> não imprime mensagem de erro,
75
aborta execução de instruções e retorna com <literal>ierr</literal> e
76
igual ao número de erro. Se o flag 'errcatch' não estiver presente, a
77
manipulação de erros padrão é utilizada.
81
<title>Observação </title>
82
<para>Arquivos executáveis (exec files) podem agora ser usados para
83
definir funções "inline" utilizando a sintaxe de definição (ver
88
88
<para><literal>exec</literal> supports files encoded as ANSI/ASCII and UTF-8 (NO-BOM).</para>
91
<title>Exemplos</title>
92
<programlisting role="example"><![CDATA[
91
<title>Exemplos</title>
92
<programlisting role="example"><![CDATA[
93
93
// criando um arquivo script
94
94
mputl('a=1;b=2',TMPDIR+'/meuscript')
110
110
// a e y são criadas no ambiente corrente
112
112
]]></programlisting>
115
<title>Ver Também</title>
116
<simplelist type="inline">
118
<link linkend="exec">exec</link>
121
<link linkend="execstr">execstr</link>
124
<link linkend="evstr">evstr</link>
127
<link linkend="comp">comp</link>
130
<link linkend="mode">mode</link>
133
<link linkend="chdir">chdir</link>
136
<link linkend="pwd">pwd</link>
115
<title>Ver Também</title>
116
<simplelist type="inline">
118
<link linkend="exec">exec</link>
121
<link linkend="execstr">execstr</link>
124
<link linkend="evstr">evstr</link>
127
<link linkend="comp">comp</link>
130
<link linkend="mode">mode</link>
133
<link linkend="chdir">chdir</link>
136
<link linkend="pwd">pwd</link>