1<?xml version="1.0" encoding="UTF-8"?>
2<!--
3 * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4 * Copyright (C) 2008 - INRIA
5 * Copyright (C) 2010 - DIGITEO - Allan CORNET
6 *
7 * Copyright (C) 2012 - 2016 - Scilab Enterprises
8 *
9 * This file is hereby licensed under the terms of the GNU GPL v2.0,
10 * pursuant to article 5.3.4 of the CeCILL v.2.1.
11 * This file was originally licensed under the terms of the CeCILL v2.1,
12 * and continues to be available under such terms.
13 * For more information, see the COPYING file which you should have received
14 * along with this program.
15 *
16 -->
17<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" xmlns:scilab="http://www.scilab.org" xml:id="fprintfMat" xml:lang="ru">
18    <refnamediv>
19        <refname>fprintfMat</refname>
20        <refpurpose>записывает матрицу в файл</refpurpose>
21    </refnamediv>
22    <refsynopsisdiv>
23        <title>Синтаксис</title>
24        <synopsis>fprintfMat(file, M [,format, text])</synopsis>
25    </refsynopsisdiv>
26    <refsection>
27        <title>Аргументы</title>
28        <variablelist>
29            <varlistentry>
30                <term>file</term>
31                <listitem>
32                    <para>строка, путь к файлу, который нужно записать</para>
33                </listitem>
34            </varlistentry>
35            <varlistentry>
36                <term>M</term>
37                <listitem>
38                    <para>матрица вещественных чисел</para>
39                </listitem>
40            </varlistentry>
41            <varlistentry>
42                <term>format</term>
43                <listitem>
44                    <para>
45                        символьная строка, задающая формат. Это необязательный
46                        параметр, значение по умолчанию <literal>"%lf"</literal>.
47                    </para>
48                    <para>
49                        Поддерживаемый формат:
50                        <literal>%[width].[precision]type</literal> или
51                        <literal>%type</literal>, где:
52                    </para>
53                    <para>
54                        <literal>width</literal>: необязательное число, которое
55                        определяет минимальное количество символов на выходе;
56                    </para>
57                    <para>
58                        <literal>precision</literal>: необязательное число,
59                        которое определяет максимальное количество символов,
60                        напечатанных для всего или части выходного поля, или
61                        минимальное количество цифр, печатаемых для целых значений;
62                    </para>
63                    <para>
64                        <literal>type</literal>: lf, lg, d, i, e, f, g (см. <link
65            linkend="scanf_conversion">scanf_conversion</link>).
66                    </para>
67                </listitem>
68            </varlistentry>
69            <varlistentry>
70                <term>text</term>
71                <listitem>
72                    <para>
73                        вектор-строка или вектор-столбец строк, указывающий
74                        нечисловые комментарии в начале файла.
75                    </para>
76                </listitem>
77            </varlistentry>
78        </variablelist>
79    </refsection>
80    <refsection>
81        <title>Описание</title>
82        <para>
83            Функция <function>fprintfMat</function> записывает матрицу в
84            форматированном файле. Каждая строка матрицы даёт строчку в
85            файле. Если указан <varname>text</varname>, то его элементы
86            вносятся (поэлементно) в начало файла, один элемент на строку.
87        </para>
88    </refsection>
89    <refsection>
90        <title>Примеры</title>
91        <programlisting role="example"><![CDATA[
92n = 50;
93a = rand(n, n, "u");
94fprintfMat(TMPDIR + "/Mat", a, "%5.2f");
95a1 = fscanfMat(TMPDIR + "/Mat");
96
97// Создадим файл Mat1 и внесём в него комментарий
98some_comment = ["Это комментарий.","Это вторая строчка комментария.","Это третья строчка комментария."];
99fprintfMat(TMPDIR + "/Mat1", a, "%5.2f",some_comment);
100   ]]> </programlisting>
101    </refsection>
102    <refsection role="see also">
103        <title>Смотрите также</title>
104        <simplelist type="inline">
105            <member>
106                <link linkend="scanf_conversion">scanf_conversion</link>
107            </member>
108            <member>
109                <link linkend="mclose">mclose</link>
110            </member>
111            <member>
112                <link linkend="meof">meof</link>
113            </member>
114            <member>
115                <link linkend="mfprintf">mfprintf</link>
116            </member>
117            <member>
118                <link linkend="mfscanf">mfscanf</link>
119            </member>
120            <member>
121                <link linkend="fscanfMat">fscanfMat</link>
122            </member>
123            <member>
124                <link linkend="mget">mget</link>
125            </member>
126            <member>
127                <link linkend="mgetstr">mgetstr</link>
128            </member>
129            <member>
130                <link linkend="mopen">mopen</link>
131            </member>
132            <member>
133                <link linkend="mprintf">mprintf</link>
134            </member>
135            <member>
136                <link linkend="mput">mput</link>
137            </member>
138            <member>
139                <link linkend="mputstr">mputstr</link>
140            </member>
141            <member>
142                <link linkend="mseek">mseek</link>
143            </member>
144            <member>
145                <link linkend="mtell">mtell</link>
146            </member>
147            <member>
148                <link linkend="mdelete">mdelete</link>
149            </member>
150        </simplelist>
151    </refsection>
152</refentry>
153
154