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

« back to all changes in this revision

Viewing changes to modules/io/help/pt_BR/write.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:
11
11
 *
12
12
 -->
13
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:ns4="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="write" xml:lang="en">
14
 
  <refnamediv>
15
 
    <refname>write</refname>
16
 
    <refpurpose>Escrita em arquivo formatado</refpurpose>
17
 
  </refnamediv>
18
 
  <refsynopsisdiv>
19
 
    <title>Seq��ncia de Chamamento</title>
20
 
    <synopsis>write(file-desc,a,[format])
21
 
      write(file-desc,a,k,format)
22
 
    </synopsis>
23
 
  </refsynopsisdiv>
24
 
  <refsection>
25
 
    <title>Par�metros</title>
26
 
    <variablelist>
27
 
      <varlistentry>
28
 
        <term>file-desc</term>
29
 
        <listitem>
30
 
          <para>string especificando o nome do arquivo ou valor inteiro
31
 
            especificando a unidade l�gica (ver file).
32
 
          </para>
33
 
        </listitem>
34
 
      </varlistentry>
35
 
      <varlistentry>
36
 
        <term>a</term>
37
 
        <listitem>
38
 
          <para>matriz de reais ou vetor coluna de strings</para>
39
 
        </listitem>
40
 
      </varlistentry>
41
 
      <varlistentry>
42
 
        <term>format</term>
43
 
        <listitem>
44
 
          <para>string, especifica um formato "Fortran". Este string deve
45
 
            come�ar com um par�ntese direito e terminar com um par�ntese
46
 
            esquerdo. Formatos n�o podem misturar pontos flutuantes, inteiros ou
47
 
            modo de edi��o de caractere.
48
 
          </para>
49
 
        </listitem>
50
 
      </varlistentry>
51
 
      <varlistentry>
52
 
        <term>k</term>
53
 
        <listitem>
54
 
          <para>integer vector</para>
55
 
        </listitem>
56
 
      </varlistentry>
57
 
    </variablelist>
58
 
  </refsection>
59
 
  <refsection>
60
 
    <title>Descri��o</title>
61
 
    <para>Escreve linha por linha uma matriz de reais ou um vetor coluna de
62
 
      strings em um arquivo formatado. Cada linha do argumento
63
 
      <literal>a</literal> come�a em uma nova linha do arquivo
64
 
      <literal>file-desc</literal>. Dependendo de <literal>format</literal> uma
65
 
      dada linha do argumento <literal>a</literal> pode ser escrita em mais de
66
 
      uma linha do arquivo <literal>file-desc</literal>.
67
 
    </para>
68
 
    <para>
69
 
      Exemplos de formatos : <literal>(1x,e10.3,5x,3(f3.0))</literal> ,
70
 
      <literal>(10x,a20)</literal> ;
71
 
    </para>
72
 
    <para>Veja um livro de Fortran para maior precis�o.</para>
73
 
    <para>Arquivos de acesso direto :
74
 
      <literal>x=write(file_desc,a,k,format)</literal>. Aqui
75
 
      <literal>k</literal> � o vetor de grava��es (uma grava��o por linha, i.e.
76
 
      <literal>m=prod(size(k)</literal>)
77
 
    </para>
78
 
    <para>
79
 
      <literal>write(%io(2),....)</literal> escreve em uma janela do
80
 
      Scilab. Note que neste caso <literal>format</literal> deve produzir uma
81
 
      linha de sa�da por linha da matriz. Se esta restri��o n�o for respeitada,
82
 
      um erro imprevis�vel acontece.
83
 
    </para>
84
 
  </refsection>
85
 
  <refsection>
86
 
    <title>Exemplos</title>
87
 
    <programlisting role="example"><![CDATA[ 
 
14
    <refnamediv>
 
15
        <refname>write</refname>
 
16
        <refpurpose>Escrita em arquivo formatado</refpurpose>
 
17
    </refnamediv>
 
18
    <refsynopsisdiv>
 
19
        <title>Seq��ncia de Chamamento</title>
 
20
        <synopsis>write(file-desc,a,[format])
 
21
            write(file-desc,a,k,format)
 
22
        </synopsis>
 
23
    </refsynopsisdiv>
 
24
    <refsection>
 
25
        <title>Par�metros</title>
 
26
        <variablelist>
 
27
            <varlistentry>
 
28
                <term>file-desc</term>
 
29
                <listitem>
 
30
                    <para>string especificando o nome do arquivo ou valor inteiro
 
31
                        especificando a unidade l�gica (ver file).
 
32
                    </para>
 
33
                </listitem>
 
34
            </varlistentry>
 
35
            <varlistentry>
 
36
                <term>a</term>
 
37
                <listitem>
 
38
                    <para>matriz de reais ou vetor coluna de strings</para>
 
39
                </listitem>
 
40
            </varlistentry>
 
41
            <varlistentry>
 
42
                <term>format</term>
 
43
                <listitem>
 
44
                    <para>string, especifica um formato "Fortran". Este string deve
 
45
                        come�ar com um par�ntese direito e terminar com um par�ntese
 
46
                        esquerdo. Formatos n�o podem misturar pontos flutuantes, inteiros ou
 
47
                        modo de edi��o de caractere.
 
48
                    </para>
 
49
                </listitem>
 
50
            </varlistentry>
 
51
            <varlistentry>
 
52
                <term>k</term>
 
53
                <listitem>
 
54
                    <para>integer vector</para>
 
55
                </listitem>
 
56
            </varlistentry>
 
57
        </variablelist>
 
58
    </refsection>
 
59
    <refsection>
 
60
        <title>Descri��o</title>
 
61
        <para>Escreve linha por linha uma matriz de reais ou um vetor coluna de
 
62
            strings em um arquivo formatado. Cada linha do argumento
 
63
            <literal>a</literal> come�a em uma nova linha do arquivo
 
64
            <literal>file-desc</literal>. Dependendo de <literal>format</literal> uma
 
65
            dada linha do argumento <literal>a</literal> pode ser escrita em mais de
 
66
            uma linha do arquivo <literal>file-desc</literal>.
 
67
        </para>
 
68
        <para>
 
69
            Exemplos de formatos : <literal>(1x,e10.3,5x,3(f3.0))</literal> ,
 
70
            <literal>(10x,a20)</literal> ;
 
71
        </para>
 
72
        <para>Veja um livro de Fortran para maior precis�o.</para>
 
73
        <para>Arquivos de acesso direto :
 
74
            <literal>x=write(file_desc,a,k,format)</literal>. Aqui
 
75
            <literal>k</literal> � o vetor de grava��es (uma grava��o por linha, i.e.
 
76
            <literal>m=prod(size(k)</literal>)
 
77
        </para>
 
78
        <para>
 
79
            <literal>write(%io(2),....)</literal> escreve em uma janela do
 
80
            Scilab. Note que neste caso <literal>format</literal> deve produzir uma
 
81
            linha de sa�da por linha da matriz. Se esta restri��o n�o for respeitada,
 
82
            um erro imprevis�vel acontece.
 
83
        </para>
 
84
    </refsection>
 
85
    <refsection>
 
86
        <title>Exemplos</title>
 
87
        <programlisting role="example"><![CDATA[ 
88
88
if getos() == 'Windows' then unix('del asave');
89
89
else unix('rm -f asave'); end
90
90
A=rand(5,3); write('asave',A); A=read('asave',5,3);
97
97
else unix('rm -f foo'); end
98
98
write('foo',A)
99
99
 ]]></programlisting>
100
 
  </refsection>
101
 
  <refsection role="see also">
102
 
    <title>Ver Tamb�m</title>
103
 
    <simplelist type="inline">
104
 
      <member>
105
 
        <link linkend="file">file</link>
106
 
      </member>
107
 
      <member>
108
 
        <link linkend="fileinfo">fileinfo</link>
109
 
      </member>
110
 
      <member>
111
 
        <link linkend="writb">writb</link>
112
 
      </member>
113
 
      <member>
114
 
        <link linkend="read">read</link>
115
 
      </member>
116
 
      <member>
117
 
        <link linkend="print">print</link>
118
 
      </member>
119
 
      <member>
120
 
        <link linkend="string">string</link>
121
 
      </member>
122
 
      <member>
123
 
        <link linkend="mfprintf">mfprintf</link>
124
 
      </member>
125
 
      <member>
126
 
        <link linkend="mprintf">mprintf</link>
127
 
      </member>
128
 
      <member>
129
 
        <link linkend="msprintf">msprintf</link>
130
 
      </member>
131
 
      <member>
132
 
        <link linkend="fprintfMat">fprintfMat</link>
133
 
      </member>
134
 
    </simplelist>
135
 
  </refsection>
 
100
    </refsection>
 
101
    <refsection role="see also">
 
102
        <title>Ver Tamb�m</title>
 
103
        <simplelist type="inline">
 
104
            <member>
 
105
                <link linkend="file">file</link>
 
106
            </member>
 
107
            <member>
 
108
                <link linkend="fileinfo">fileinfo</link>
 
109
            </member>
 
110
            <member>
 
111
                <link linkend="writb">writb</link>
 
112
            </member>
 
113
            <member>
 
114
                <link linkend="read">read</link>
 
115
            </member>
 
116
            <member>
 
117
                <link linkend="print">print</link>
 
118
            </member>
 
119
            <member>
 
120
                <link linkend="string">string</link>
 
121
            </member>
 
122
            <member>
 
123
                <link linkend="mfprintf">mfprintf</link>
 
124
            </member>
 
125
            <member>
 
126
                <link linkend="mprintf">mprintf</link>
 
127
            </member>
 
128
            <member>
 
129
                <link linkend="msprintf">msprintf</link>
 
130
            </member>
 
131
            <member>
 
132
                <link linkend="fprintfMat">fprintfMat</link>
 
133
            </member>
 
134
        </simplelist>
 
135
    </refsection>
136
136
</refentry>