Merge commit 'refs/remotes/origin/5.1'
[scilab.git] / scilab / modules / dynamic_link / help / pt_BR / call.xml
index 71c47f2..75f6311 100644 (file)
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="UTF-8"?>
+<?xml version="1.0" encoding="ISO-8859-1"?>
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) INRIA - 
   <refnamediv>
     <refname>call</refname>
 
-    <refpurpose>chamada a rotinas de usuário FORTRAN ou C</refpurpose>
+    <refpurpose>chamada a rotinas de usuário FORTRAN ou C</refpurpose>
   </refnamediv>
 
   <refsynopsisdiv>
-    <title>Seqüência de Chamamento</title>
+    <title>Seqüência de Chamamento</title>
 
-    <synopsis>// forma longa: 'out' está presente  
+    <synopsis>// forma longa: 'out' está presente  
 [y1,...,yk]=call("ident",x1,px1,"tx1",...,xn,pxn,"txn", 
 "out",[ny1,my1],py1,"ty1",...,[nyl,myl],pyl,"tyl") 
-// forma curta : nenhum parâmetro 'out' 
+// forma curta : nenhum parâmetro 'out' 
 [y1,....,yk]=call("ident",x1,...,xn) </synopsis>
   </refsynopsisdiv>
 
   <refsection>
-    <title>Parâmetros</title>
+    <title>Parâmetros</title>
 
     <variablelist>
       <varlistentry>
   </refsection>
 
   <refsection>
-    <title>Descrição</title>
+    <title>Descrição</title>
 
-    <para>Chamada interativa ao programa do usuário FORTRAN (ou C) do Scilab.
+    <para>Chamada interativa ao programa do usuário FORTRAN (ou C) do Scilab.
     A rotina deve estar previamente linkada ("ligada") ao Scilab. Este link
     pode ser feito:</para>
 
     <itemizedlist>
       <listitem>
         <para>Com o comando "<literal>link</literal>" do Scilab (linkagem
-        "suave" ("soft") incremental) durante a sessão Scilab. (ver
+        "suave" ("soft") incremental) durante a sessão Scilab. (ver
         <literal>link</literal>)</para>
       </listitem>
     </itemizedlist>
 
-    <para>Há duas formas de sintaxe de chamamento, uma curta e uma longa. A
-    curta fornece um código mais rápido e uma sintaxe de chamamento mais
-    fácil, mas deve-se escrever uma pequena interface (C ou FORTRAN) para que
-    esta forma seja possível. A forma longa torna possível uma chamada a uma
-    rotina FORTRAN (ou C) sem modificação do código, mas a sintaxe é mais
-    complexa e o código interpretado mais devagar.</para>
+    <para>Há duas formas de sintaxe de chamamento, uma curta e uma longa. A
+    curta fornece um código mais rápido e uma sintaxe de chamamento mais
+    fácil, mas deve-se escrever uma pequena interface (C ou FORTRAN) para que
+    esta forma seja possível. A forma longa torna possível uma chamada a uma
+    rotina FORTRAN (ou C) sem modificação do código, mas a sintaxe é mais
+    complexa e o código interpretado mais devagar.</para>
 
-    <para>O significado de cada parâmetro é descrito abaixo:</para>
+    <para>O significado de cada parâmetro é descrito abaixo: </para>
 
     <variablelist>
       <varlistentry>
         <term>"ident"</term>
 
         <listitem>
-          <para>é o nome da subrotina chamada.</para>
+          <para>é o nome da subrotina chamada. </para>
         </listitem>
       </varlistentry>
 
         <term>x1,...,xn</term>
 
         <listitem>
-          <para>são as variáveis de entrada (strings ou matrizes de reais)
-          enviados à rotina</para>
+          <para>são as variáveis de entrada (strings ou matrizes de reais)
+          enviados à rotina</para>
         </listitem>
       </varlistentry>
 
         <term>px1,...,pxn</term>
 
         <listitem>
-          <para>são as respectivas posições destas variáveis na seqüência de
+          <para>são as respectivas posições destas variáveis na seqüência de
           chamamento da rotina <literal>"ident"</literal> e</para>
         </listitem>
       </varlistentry>
         <term>tx1,...,txn</term>
 
         <listitem>
-          <para>são seus tipos (<literal>"r"</literal>,
+          <para>são seus tipos (<literal>"r"</literal>,
           <literal>"i"</literal>, <literal>"d"</literal> e
           <literal>"c"</literal> para ponto flutuante real , inteiro, dupla
-          precisão e strings)</para>
+          precisão e strings) </para>
         </listitem>
       </varlistentry>
 
         <term>"out"</term>
 
         <listitem>
-          <para>é a palavra-chave usada para separar variáveis de entrada das
-          variáveis de saída. Quando esta palavra-chave está presente, ela
-          indica que a forma longa será usada e quando não está presente,
-          indica que a forma curta será usada.</para>
+          <para>é a palavra-chave usada para separar variáveis de entrada das
+          variáveis de saída. Quando esta palavra-chave está presente, ela
+          indica que a forma longa será usada e quando não está presente,
+          indica que a forma curta será usada. </para>
         </listitem>
       </varlistentry>
 
         <term>[ny1, my1]</term>
 
         <listitem>
-          <para>são os tamanhos (número de linhas e colunas. Para argumentos
-          'c',<literal> m1*n1</literal> é o número de caracteres) das
-          variáveis de saída e</para>
+          <para>são os tamanhos (número de linhas e colunas. Para argumentos
+          'c',<literal> m1*n1</literal> é o número de caracteres) das
+          variáveis de saída e </para>
         </listitem>
       </varlistentry>
 
         <term>py1, ...</term>
 
         <listitem>
-          <para>são as posições das variáveis de saída (possivelmente iguais a
-          <literal>pxi</literal> ) na seqüência de chamamento da rotina. Os
+          <para>são as posições das variáveis de saída (possivelmente iguais a
+          <literal>pxi</literal> ) na seqüência de chamamento da rotina. Os
           inteiros <literal>pyi</literal>'s devem estar em ordem
           crescente.</para>
         </listitem>
         <term>"ty1", ...</term>
 
         <listitem>
-          <para>são os tipos FORTRAN das variáveis de saída. As
-          <literal>k</literal> primeiras variáveis de saída são postas em
+          <para>são os tipos FORTRAN das variáveis de saída. As
+          <literal>k</literal> primeiras variáveis de saída são postas em
           <literal>y1,..., yk</literal>.</para>
         </listitem>
       </varlistentry>
     </variablelist>
 
-    <para>Se uma variável de saída coincide com uma variável de entrada (i.e.,
-    <literal>pyi=pxj</literal> ) pode-se apenas passar sua posição
-    <literal>pyi</literal> . O tamanho e tipo de <literal>yi</literal> são
-    então os mesmos que os de<literal>xi</literal>. Se uma variável de saída
-    coincide com uma variável de entrada e são especificadas as dimensões da
-    variável de saída, <literal>[myl,nyl]</literal> deve satisfazer a condição
+    <para>Se uma variável de saída coincide com uma variável de entrada (i.e.,
+    <literal>pyi=pxj</literal> ) pode-se apenas passar sua posição
+    <literal>pyi</literal> . O tamanho e tipo de <literal>yi</literal> são
+    então os mesmos que os de<literal>xi</literal>. Se uma variável de saída
+    coincide com uma variável de entrada e são especificadas as dimensões da
+    variável de saída, <literal>[myl,nyl]</literal> deve satisfazer a condição
     de compatibilidade <literal>mxk*nxk &gt;= myl*nyl</literal>.</para>
   </refsection>
 
   <refsection>
     <title>Exemplos</title>
 
-    <programlisting role="example">    //Exemplo 1 com um código C simples
+    <programlisting role="example">
+    
+    //Exemplo 1 com um código C simples
     f1=['#include &lt;math.h&gt;'
         'void fooc(c,a,b,m,n)'
          'double a[],*b,c[];'
 
     mputl(f1,'fooc.c')
 
-    //criando a biblioteca compartilhada (um gateway (ligação), um Makefile e um loader (carregador) são 
+    //criando a biblioteca compartilhada (um gateway (ligação), um Makefile e um loader (carregador) são 
     //gerados.)  
 
     ilib_for_link('fooc','fooc.o',[],"c") 
     [m,n]=size(a);
 
     // Entradas:
-    // a está na posição 2 e double
+    // a está na posição 2 e double
     // b                3     double
     // n                4     integer
     // m                5     integer
-    // Saídas:
-    // c está na posição 1 e double com tamanho [m,n]
+    // Saídas:
+    // c está na posição 1 e double com tamanho [m,n]
     c=call("fooc",a,2,"d",b,3,"d",m,4,"i",n,5,"i","out",[m,n],1,"d");
 
-    //Exemplo 2 com um código FORTRAN simples
+    //Exemplo 2 com um código FORTRAN simples
     f1=['      subroutine foof(c,a,b,n,m)'
         '      integer n,m'
         '      double precision a(*),b,c(*)'
         '      end'];
     mputl(f1,'foof.f')
 
-    //criando a biblioteca compartilhada (um gateway, um Makefile e um loader são  
+    //criando a biblioteca compartilhada (um gateway, um Makefile e um loader são  
     //gerados.)  
 
     ilib_for_link('foof','foof.o',[],"f") 
   </refsection>
 
   <refsection>
-    <title>Ver Também</title>
+    <title>Ver Também</title>
 
     <simplelist type="inline">
       <member><link linkend="link">link</link></member>