Add sample SOD and ZCOS icons files
[scilab.git] / scilab / modules / fileio / help / ru_RU / fprintfMat.xml
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  * This file must be used under the terms of the CeCILL.
8  * This source file is licensed as described in the file COPYING, which
9  * you should have received as part of this distribution.  The terms
10  * are also available at    
11  * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
12  *
13  -->
14 <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">
15     <refnamediv>
16         <refname>fprintfMat</refname>
17         <refpurpose>записывает матрицу в файл</refpurpose>
18     </refnamediv>
19     <refsynopsisdiv>
20         <title>Последовательность вызова</title>
21         <synopsis>fprintfMat(file, M [,format, text])</synopsis>
22     </refsynopsisdiv>
23     <refsection>
24         <title>Аргументы</title>
25         <variablelist>
26             <varlistentry>
27                 <term>file</term>
28                 <listitem>
29                     <para>строка, путь к файлу, который нужно записать</para>
30                 </listitem>
31             </varlistentry>
32             <varlistentry>
33                 <term>M</term>
34                 <listitem>
35                     <para>матрица вещественных чисел</para>
36                 </listitem>
37             </varlistentry>
38             <varlistentry>
39                 <term>format</term>
40                 <listitem>
41                     <para>
42                         символьная строка, задающая формат. Это необязательный
43                         параметр, значение по умолчанию <literal>"%lf"</literal>.
44                     </para>
45                     <para>
46                         Поддерживаемый формат:
47                         <literal>%[width].[precision]type</literal> или
48                         <literal>%type</literal>, где:
49                     </para>
50                     <para>
51                         <literal>width</literal>: необязательное число, которое
52                         определяет минимальное количество символов на выходе;
53                     </para>
54                     <para>
55                         <literal>precision</literal>: необязательное число,
56                         которое определяет максимальное количество символов,
57                         напечатанных для всего или части выходного поля, или
58                         минимальное количество цифр, печатаемых для целых значений;
59                     </para>
60                     <para>
61                         <literal>type</literal>: lf, lg, d, i, e, f, g (см. <link
62             linkend="scanf_conversion">scanf_conversion</link>).
63                     </para>
64                 </listitem>
65             </varlistentry>
66             <varlistentry>
67                 <term>text</term>
68                 <listitem>
69                     <para>
70                         вектор-строка или вектор-столбец строк, указывающий
71                         нечисловые комментарии в начале файла.
72                     </para>
73                 </listitem>
74             </varlistentry>
75         </variablelist>
76     </refsection>
77     <refsection>
78         <title>Описание</title>
79         <para>
80             Функция <literal>fprintfMat</literal> записывает матрицу в
81             форматированном файле. Каждая строка матрицы даёт строчку в
82             файле. Если указан <literal>text</literal>, то его элементы
83             вносятся (поэлементно) в начало файла, один элемент на строку.
84         </para>
85     </refsection>
86     <refsection>
87         <title>Примеры</title>
88         <programlisting role="example"><![CDATA[ 
89 n = 50;
90 a = rand(n, n, "u");
91 fprintfMat(TMPDIR + "/Mat", a, "%5.2f");
92 a1 = fscanfMat(TMPDIR + "/Mat");
93
94 // Создадим файл Mat1 и внесём в него комментарий
95 some_comment = ["Это комментарий.","Это вторая строчка комментария.","Это третья строчка комментария."];
96 fprintfMat(TMPDIR + "/Mat1", a, "%5.2f",some_comment);
97    ]]> </programlisting>
98     </refsection>
99     <refsection role="see also">
100         <title>Смотрите также</title>
101         <simplelist type="inline">
102             <member>
103                 <link linkend="scanf_conversion">scanf_conversion</link>
104             </member>
105             <member>
106                 <link linkend="mclose">mclose</link>
107             </member>
108             <member>
109                 <link linkend="meof">meof</link>
110             </member>
111             <member>
112                 <link linkend="mfprintf">mfprintf</link>
113             </member>
114             <member>
115                 <link linkend="mfscanf">mfscanf</link>
116             </member>
117             <member>
118                 <link linkend="fscanfMat">fscanfMat</link>
119             </member>
120             <member>
121                 <link linkend="mget">mget</link>
122             </member>
123             <member>
124                 <link linkend="mgetstr">mgetstr</link>
125             </member>
126             <member>
127                 <link linkend="mopen">mopen</link>
128             </member>
129             <member>
130                 <link linkend="mprintf">mprintf</link>
131             </member>
132             <member>
133                 <link linkend="mput">mput</link>
134             </member>
135             <member>
136                 <link linkend="mputstr">mputstr</link>
137             </member>
138             <member>
139                 <link linkend="mscanf">mscanf</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