* Bug 15431 fixed [doc]: empty [] better documented
[scilab.git] / scilab / modules / string / help / pt_BR / string.xml
index 4fd96ec..df2636f 100644 (file)
@@ -2,8 +2,8 @@
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) INRIA -
- *
  * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ * Copyright (C) 2019 - Samuel GOUGEON
  *
  * This file is hereby licensed under the terms of the GNU GPL v2.0,
  * pursuant to article 5.3.4 of the CeCILL v.2.1.
  * along with this program.
  *
  -->
-<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns3="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="string" xml:lang="pt">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns3="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="string" xml:lang="pt">
     <refnamediv>
         <refname>string</refname>
         <refpurpose>conversão para string (cadeia de caracteres)</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Seqüência de Chamamento</title>
-        <synopsis>string(x)
-            [out, in, text] = string(x)
+        <synopsis>
+            text = string(x)
+            [out, in, text] = string(SciFun)
         </synopsis>
     </refsynopsisdiv>
     <refsection>
                     <para>matriz de reais ou função</para>
                 </listitem>
             </varlistentry>
+            <varlistentry>
+                <term>SciFun</term>
+                <listitem>
+                    <para>
+                        a function in Scilab language (handle of type 13, not its name as a string).
+                    </para>
+                </listitem>
+            </varlistentry>
         </variablelist>
     </refsection>
     <refsection>
         <title>Descrição</title>
         <para>Converte uma matriz em uma matriz de strings.</para>
         <para>
-            Se <literal>x</literal> é uma função <literal>[out, in, text] =
-                string(x)
-            </literal>
+            Se <varname>SciFun</varname> é uma função <literal>[out, in, text] = string(x)</literal>
             retorna três vetores de strings :
-            <literal>out</literal> é o vetor de variáveis de saída,
-            <literal>in</literal> é o vetor de variáveis de entrada, e
-            <literal>text</literal> é o vetor (coluna) do código fonte da
-            função.
+            <itemizedlist>
+                <listitem>
+                    <varname>out</varname> é o vetor de variáveis de saída,
+                </listitem>
+                <listitem>
+                    <varname>in</varname> é o vetor de variáveis de entrada, e
+                </listitem>
+                <listitem>
+                    <varname>text</varname>  é o vetor (coluna) do código fonte da função.
+                </listitem>
+            </itemizedlist>
         </para>
         <para>
-            Se <literal>x</literal> é uma variável <literal>lib</literal>
+            Se <varname>x</varname> é uma variável <literal>lib</literal>
             (bibiloteca), text é um vetor coluna de strings. O primeiro elemento
             contém o endereço do arquivo biblioteca e o outro o nome da função que ela
             define.
         </para>
+        <warning>
+            For any complex, real, integer, polynomial or rational input, the format of literal
+            numbers output from <function>string(..)</function> is managed by the
+            <link linkend="format">format</link> function (see examples).
+        </warning>
         <para>
-            Strings são definidos como <literal>'string'</literal> (entre aspas
-            simples) ou <literal>"string"</literal> (entre aspas duplas); matrizes de
-            strings são definidas como matrizes de constantes.
-        </para>
-        <para>Concatenação de strings é feita pela operação
-            <literal>+</literal>.
+            Note that string([]) returns [] (unchanged).
         </para>
     </refsection>
     <refsection>
         <title>Exemplos</title>
-        <programlisting role="example">string(rand(2, 2))
+        <programlisting role="example">
+            string(rand(2, 2))
 
             deff("y = mymacro(x)", "y = x + 1")
             [out, in, text] = string(mymacro)
             format(24);
             disp(string(%pi))
             format(v(2))
+
+            string(1:4:$)
         </programlisting>
     </refsection>
     <refsection role="see also">
         <title>Ver Também</title>
         <simplelist type="inline">
             <member>
-                <link linkend="part">part</link>
-            </member>
-            <member>
-                <link linkend="length">length</link>
+                <link linkend="format">format</link>
             </member>
             <member>
-                <link linkend="quote">quote</link>
+                <link linkend="sci2exp">sci2exp</link>
             </member>
             <member>
-                <link linkend="evstr">evstr</link>
+                <link linkend="msprintf">msprintf</link>
             </member>
             <member>
-                <link linkend="execstr">execstr</link>
+                <link linkend="tree2code">tree2code</link>
             </member>
             <member>
-                <link linkend="strsubst">strsubst</link>
+                <link linkend="pol2str">pol2str</link>
             </member>
             <member>
-                <link linkend="strcat">strcat</link>
+                <link linkend="execstr">execstr</link>
             </member>
             <member>
-                <link linkend="strindex">strindex</link>
+                <link linkend="evstr">evstr</link>
             </member>
             <member>
-                <link linkend="sci2exp">sci2exp</link>
+                <link linkend="strtod">strtod</link>
             </member>
             <member>
-                <link linkend="format">format</link>
+                <link linkend="csvTextScan">csvTextScan</link>
             </member>
         </simplelist>
     </refsection>
+    <refsection>
+        <title>Histórico</title>
+        <revhistory>
+            <revision>
+                <revnumber>5.4.0</revnumber>
+                <revremark>
+                    implicitlist typeof input accepted.
+                </revremark>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>