~ubuntu-branches/ubuntu/trusty/scilab/trusty

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
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
<?xml version="1.0" encoding="UTF-8"?>
<!--
 * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
 * Copyright (C) 2008 - INRIA
 * Copyright (C) 2010 - DIGITEO - Allan CORNET
 * 
 * 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-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: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="fprintfMat" xml:lang="ru">
  <refnamediv>
    <refname>fprintfMat</refname>
    <refpurpose>записывает матрицу в файл</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <title>Последовательность вызова</title>
    <synopsis>fprintfMat(file,M [,format,text])</synopsis>
  </refsynopsisdiv>
  <refsection>
    <title>Аргументы</title>
    <variablelist>
      <varlistentry>
        <term>file</term>
        <listitem>
          <para>строка, путь к файлу, который нужно записать</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>M</term>
        <listitem>
          <para>матрица вещественных чисел</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>format</term>
        <listitem>
          <para>
            символьная строка, задающая формат. Это необязательный
            параметр, значение по умолчанию <literal>"%lf"</literal>.
          </para>
          <para>
            Поддерживаемый формат:
            <literal>%[width].[precision]type</literal> или
            <literal>%type</literal>, где:
          </para>
          <para>
            <literal>width</literal>: необязательное число, которое
            определяет минимальное количество символов на выходе;
          </para>
          <para>
            <literal>precision</literal>: необязательное число,
            которое определеяет максимальное количество символов,
            напечатанных для всего или части выходного поля, или
            минимальное количество цифр, печатаемых для целых значений;
          </para>
          <para>
            <literal>type</literal>: lf, lg, d, i, e, f, g (см. <link
            linkend="scanf_conversion">scanf_conversion</link>).
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>text</term>
        <listitem>
          <para>
            вектор-строка или вектор-столбец строк, указывающий
            нечисловые комментарии в начале файла.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsection>
  <refsection>
    <title>Описание</title>
    <para>
      Функция <literal>fprintfMat</literal> записывает матрицу в
      форматированном файле. Каждая строка матрицы даёт строчку в
      файле. Если указан <literal>text</literal>, то его элементы
      вносятся (поэлементно) в начало файла, один элемент на строку.
    </para>
  </refsection>
  <refsection>
    <title>Примеры</title>
    <programlisting role="example"><![CDATA[ 
n = 50;
a = rand(n, n, "u");
fprintfMat(TMPDIR + "/Mat", a, "%5.2f");
a1 = fscanfMat(TMPDIR + "/Mat");

// Создадим файл Mat1 и внесём в него комментарий
some_comment = ["Это комментарий.","Это вторая строчка комментария.","Это третья строчка комментария."];
fprintfMat(TMPDIR + "/Mat1", a, "%5.2f",some_comment);
   ]]> </programlisting>
  </refsection>
  <refsection role="see also">
    <title>Смотрите также</title>
    <simplelist type="inline">
      <member>
        <link linkend="scanf_conversion">scanf_conversion</link>
      </member>
      <member>
        <link linkend="mclose">mclose</link>
      </member>
      <member>
        <link linkend="meof">meof</link>
      </member>
      <member>
        <link linkend="mfprintf">mfprintf</link>
      </member>
      <member>
        <link linkend="mfscanf">mfscanf</link>
      </member>
      <member>
        <link linkend="fscanfMat">fscanfMat</link>
      </member>
      <member>
        <link linkend="mget">mget</link>
      </member>
      <member>
        <link linkend="mgetstr">mgetstr</link>
      </member>
      <member>
        <link linkend="mopen">mopen</link>
      </member>
      <member>
        <link linkend="mprintf">mprintf</link>
      </member>
      <member>
        <link linkend="mput">mput</link>
      </member>
      <member>
        <link linkend="mputstr">mputstr</link>
      </member>
      <member>
        <link linkend="mscanf">mscanf</link>
      </member>
      <member>
        <link linkend="mseek">mseek</link>
      </member>
      <member>
        <link linkend="mtell">mtell</link>
      </member>
      <member>
        <link linkend="mdelete">mdelete</link>
      </member>
    </simplelist>
  </refsection>
</refentry>