Revision of help page for macro
[scilab.git] / scilab / modules / functions / help / pt_BR / macro.xml
1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) ????-2008 - INRIA
5  *
6  * This file must be used under the terms of the CeCILL.
7  * This source file is licensed as described in the file COPYING, which
8  * you should have received as part of this distribution.  The terms
9  * are also available at
10  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
11  *
12  -->
13 <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" xmlns:scilab="http://www.scilab.org" xml:id="macro" xml:lang="pt">
14     <refnamediv>
15         <refname>macro</refname>
16         <refpurpose>Procedimento Scilab e objeto Scilab</refpurpose>
17     </refnamediv>
18     <refsection>
19         <title>Descrição</title>
20         <para>Macros são procedimentos Scilab ("macro", "função" e "procedimento"
21             possuem o mesmo significado). Geralmente, eles são definidos em arquivos
22             com um editor e carregados no Scilab com <function>exec</function> ou
23             através de uma biblioteca.
24         </para>
25         <para>
26             Também podem ser definidos on-line (ver <link linkend="deff">deff</link>). Um
27             arquivo que contém uma macro deve começar como segue:
28         </para>
29         <programlisting role='no-scilab-exec'><![CDATA[
30 function [y1,...,yn]=foo(x1,...,xm)
31  ]]></programlisting>
32         <para>
33             Os <literal>yi</literal> são variáveis de saída calculadas como
34             funções de variáveis de entrada e variáveis existentes no Scilab quando o
35             macro é executado. Um macro pode ser compilado para uma execução mais
36             rápida. Coleções de macros podem ser armazenadas em bibliotecas. Macros
37             que começam pelo símbolo <literal>%</literal> (ex.:
38             <literal>%foo</literal>) e cujos argumentos são listas são usadas para
39             executar operações específicas: por exemplo,
40             <code>z=%rmr(x,y)</code> é equivalente a <code>z=x*y</code>
41             quando <varname>x</varname> e <varname>z</varname> são racionais (i.e.
42             <code>x=list('r',n,d,[])</code> com <varname>n</varname> e
43             <varname>d</varname> polinômios).
44         </para>
45     </refsection>
46     <refsection role="see also">
47         <title>Ver Também</title>
48         <simplelist type="inline">
49             <member>
50                 <link linkend="deff">deff</link>
51             </member>
52             <member>
53                 <link linkend="comp">comp</link>
54             </member>
55             <member>
56                 <link linkend="lib">lib</link>
57             </member>
58         </simplelist>
59     </refsection>
60 </refentry>