summaryrefslogtreecommitdiff
path: root/modules/string/help/pt_BR/string.xml
blob: 5389fab4568acd1fea061ca8e22ab98d5f9866a3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
 * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
 * Copyright (C) INRIA - 
 * 
 * This file must be used under the terms of the CeCILL.
 * This source file is licensed as described in the file COPYING, which
 * you should have received as part of this distribution.  The terms
 * are also available at    
 * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
 *
 -->
<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="en">
    <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>
    </refsynopsisdiv>
    <refsection>
        <title>Parâmetros</title>
        <variablelist>
            <varlistentry>
                <term>x</term>
                <listitem>
                    <para>matriz de reais ou função</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>
            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.
        </para>
        <para>
            Se <literal>x</literal> é 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>
        <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>.
        </para>
    </refsection>
    <refsection>
        <title>Exemplos</title>
        <programlisting role="example">string(rand(2, 2))
            
            deff("y = mymacro(x)", "y = x + 1")
            [out, in, text] = string(mymacro)
            x = 123.356; 
            disp("Result is " + string(x));
            
            disp("/" + string(~%t) + "/");
            disp("/" + string(%i+1) + "/");
            disp("/" + string(int16(-123)) + "/");
            disp("/" + string(1 + %s + %s^3) + "/");
            
            string(corelib)
            
            v = format();
            disp(string(%pi))
            format(24);
            disp(string(%pi))
            format(v(2))
        </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>
            </member>
            <member>
                <link linkend="quote">quote</link>
            </member>
            <member>
                <link linkend="evstr">evstr</link>
            </member>
            <member>
                <link linkend="execstr">execstr</link>
            </member>
            <member>
                <link linkend="strsubst">strsubst</link>
            </member>
            <member>
                <link linkend="strcat">strcat</link>
            </member>
            <member>
                <link linkend="strindex">strindex</link>
            </member>
            <member>
                <link linkend="sci2exp">sci2exp</link>
            </member>
            <member>
                <link linkend="format">format</link>
            </member>
        </simplelist>
    </refsection>
</refentry>