~ubuntu-branches/ubuntu/raring/scilab/raring-proposed

« back to all changes in this revision

Viewing changes to modules/functions/help/pt_BR/exec.xml

  • Committer: Package Import Robot
  • Author(s): Sylvestre Ledru
  • Date: 2012-08-30 14:42:38 UTC
  • mfrom: (1.4.7)
  • Revision ID: package-import@ubuntu.com-20120830144238-c1y2og7dbm7m9nig
Tags: 5.4.0-beta-3-1~exp1
* New upstream release
* Update the scirenderer dep
* Get ride of libjhdf5-java dependency

Show diffs side-by-side

added added

removed removed

Lines of Context:
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">
3
 
  <refnamediv>
4
 
    <refname>exec</refname>
5
 
    <refpurpose>execução de arquivo script ("script" significa
6
 
      roteiro)
7
 
    </refpurpose>
8
 
  </refnamediv>
9
 
  <refsynopsisdiv>
10
 
    <title>Seqüência de Chamamento</title>
11
 
    <synopsis>exec(path [,mode])
12
 
      exec(fun [,mode])
13
 
      ierr=exec(path,'errcatch' [,mode])
14
 
      ierr=exec(fun,'errcatch' [,mode])
15
 
    </synopsis>
16
 
  </refsynopsisdiv>
17
 
  <refsection>
18
 
    <title>Parâmetros</title>
19
 
    <variablelist>
20
 
      <varlistentry>
21
 
        <term>path</term>
22
 
        <listitem>
23
 
          <para>string, o endereço do arquivo script </para>
24
 
        </listitem>
25
 
      </varlistentry>
26
 
      <varlistentry>
27
 
        <term>mode</term>
28
 
        <listitem>
29
 
          <para>escalar inteiro, o modo de execução (ver abaixo) </para>
30
 
        </listitem>
31
 
      </varlistentry>
32
 
      <varlistentry>
33
 
        <term>fun</term>
34
 
        <listitem>
35
 
          <para>uma função do Scilab </para>
36
 
        </listitem>
37
 
      </varlistentry>
38
 
      <varlistentry>
39
 
        <term>ierr</term>
40
 
        <listitem>
41
 
          <para>inteiro, 0 ou número de erro</para>
42
 
        </listitem>
43
 
      </varlistentry>
44
 
    </variablelist>
45
 
  </refsection>
46
 
  <refsection>
47
 
    <title>Descrição</title>
48
 
    <para>
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> .
52
 
    </para>
53
 
    <para>
54
 
      Os casos diferentes para <literal>mode</literal> são :
55
 
    </para>
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 --&gt; é 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
62
 
      de carro.
63
 
    </para>
64
 
    <para>7 : paradas + prompts + ecos : útil para demos.</para>
65
 
    <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
71
 
      bibliotecas.
72
 
    </para>
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.
78
 
    </para>
79
 
  </refsection>
80
 
  <refsection>
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
84
 
      function).
85
 
    </para>
86
 
  </refsection>
87
 
  <!--
 
3
    <refnamediv>
 
4
        <refname>exec</refname>
 
5
        <refpurpose>execução de arquivo script ("script" significa
 
6
            roteiro)
 
7
        </refpurpose>
 
8
    </refnamediv>
 
9
    <refsynopsisdiv>
 
10
        <title>Seqüência de Chamamento</title>
 
11
        <synopsis>exec(path [,mode])
 
12
            exec(fun [,mode])
 
13
            ierr=exec(path,'errcatch' [,mode])
 
14
            ierr=exec(fun,'errcatch' [,mode])
 
15
        </synopsis>
 
16
    </refsynopsisdiv>
 
17
    <refsection>
 
18
        <title>Parâmetros</title>
 
19
        <variablelist>
 
20
            <varlistentry>
 
21
                <term>path</term>
 
22
                <listitem>
 
23
                    <para>string, o endereço do arquivo script </para>
 
24
                </listitem>
 
25
            </varlistentry>
 
26
            <varlistentry>
 
27
                <term>mode</term>
 
28
                <listitem>
 
29
                    <para>escalar inteiro, o modo de execução (ver abaixo) </para>
 
30
                </listitem>
 
31
            </varlistentry>
 
32
            <varlistentry>
 
33
                <term>fun</term>
 
34
                <listitem>
 
35
                    <para>uma função do Scilab </para>
 
36
                </listitem>
 
37
            </varlistentry>
 
38
            <varlistentry>
 
39
                <term>ierr</term>
 
40
                <listitem>
 
41
                    <para>inteiro, 0 ou número de erro</para>
 
42
                </listitem>
 
43
            </varlistentry>
 
44
        </variablelist>
 
45
    </refsection>
 
46
    <refsection>
 
47
        <title>Descrição</title>
 
48
        <para>
 
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> .
 
52
        </para>
 
53
        <para>
 
54
            Os casos diferentes para <literal>mode</literal> são :
 
55
        </para>
 
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 --&gt; é 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
 
62
            de carro.
 
63
        </para>
 
64
        <para>7 : paradas + prompts + ecos : útil para demos.</para>
 
65
        <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
 
71
            bibliotecas.
 
72
        </para>
 
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.
 
78
        </para>
 
79
    </refsection>
 
80
    <refsection>
 
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
 
84
            function).
 
85
        </para>
 
86
    </refsection>
 
87
    <!--
88
88
    <para><literal>exec</literal> supports files encoded as ANSI/ASCII and UTF-8 (NO-BOM).</para>
89
89
 -->
90
 
  <refsection>
91
 
    <title>Exemplos</title>
92
 
    <programlisting role="example"><![CDATA[ 
 
90
    <refsection>
 
91
        <title>Exemplos</title>
 
92
        <programlisting role="example"><![CDATA[ 
93
93
// criando um arquivo script
94
94
mputl('a=1;b=2',TMPDIR+'/meuscript')
95
95
// executando-o
110
110
// a e y são criadas no ambiente corrente
111
111
whos -name "a "
112
112
 ]]></programlisting>
113
 
  </refsection>
114
 
  <refsection>
115
 
    <title>Ver Também</title>
116
 
    <simplelist type="inline">
117
 
      <member>
118
 
        <link linkend="exec">exec</link>
119
 
      </member>
120
 
      <member>
121
 
        <link linkend="execstr">execstr</link>
122
 
      </member>
123
 
      <member>
124
 
        <link linkend="evstr">evstr</link>
125
 
      </member>
126
 
      <member>
127
 
        <link linkend="comp">comp</link>
128
 
      </member>
129
 
      <member>
130
 
        <link linkend="mode">mode</link>
131
 
      </member>
132
 
      <member>
133
 
        <link linkend="chdir">chdir</link>
134
 
      </member>
135
 
      <member>
136
 
        <link linkend="pwd">pwd</link>
137
 
      </member>
138
 
    </simplelist>
139
 
  </refsection>
 
113
    </refsection>
 
114
    <refsection>
 
115
        <title>Ver Também</title>
 
116
        <simplelist type="inline">
 
117
            <member>
 
118
                <link linkend="exec">exec</link>
 
119
            </member>
 
120
            <member>
 
121
                <link linkend="execstr">execstr</link>
 
122
            </member>
 
123
            <member>
 
124
                <link linkend="evstr">evstr</link>
 
125
            </member>
 
126
            <member>
 
127
                <link linkend="comp">comp</link>
 
128
            </member>
 
129
            <member>
 
130
                <link linkend="mode">mode</link>
 
131
            </member>
 
132
            <member>
 
133
                <link linkend="chdir">chdir</link>
 
134
            </member>
 
135
            <member>
 
136
                <link linkend="pwd">pwd</link>
 
137
            </member>
 
138
        </simplelist>
 
139
    </refsection>
140
140
</refentry>