[doc] gettext printf_conversion mprintf msprintf mfprintf pages updated & fixed
[scilab.git] / scilab / modules / fileio / help / ru_RU / mfprintf.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  * ...
6  * Copyright (C) 2012 - 2016 - Scilab Enterprises
7  * Copyright (C) 2021 - Samuel GOUGEON
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"
18           xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml"
19           xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
20           xmlns:scilab="http://www.scilab.org" xml:id="mfprintf" xml:lang="ru">
21     <refnamediv>
22         <refname>mfprintf</refname>
23         <refpurpose>преобразует, форматирует и записывает данные в файл</refpurpose>
24     </refnamediv>
25     <refsynopsisdiv>
26         <title>Синтаксис</title>
27         <synopsis>mfprintf(fd, format, a1, ..., an)</synopsis>
28     </refsynopsisdiv>
29     <refsection>
30         <title>Аргументы</title>
31         <variablelist>
32             <varlistentry>
33                 <term>fd</term>
34                 <listitem>
35                     <para>
36                         скаляр, файловый дескриптор, предоставленный с помощью
37                         <literal>mopen</literal> (это положительное число).
38                     </para>
39                     <para>
40                         Если <varname>fd</varname> равен 0, то перенаправление в
41                         стандартное устройство вывода сообщений об ошибках (stderr).
42                     </para>
43                     <para>
44                         Если <varname>fd</varname> равен 6, то перенаправление в
45                         стандартное устройство вывода (stdout).
46                     </para>
47                     <para>
48                         УСТАРЕЛО: значение <literal>-1</literal> относится к файлу по
49                         умолчанию (т. е. последнему открытому файлу).
50                     </para>
51                 </listitem>
52             </varlistentry>
53             <varlistentry>
54                 <term>format</term>
55                 <listitem>
56                     <para>
57                         a string providing the format to use to write all next arguments.
58                         The <varname>format</varname> follows -- as close as possible -- the C printf
59                         format operand syntax, as described in the
60                         <link linkend="printf_conversion">printf_conversion</link> page.
61                         UTF-8 extended characters are supported.
62                         <warning>
63                             Numbered placeholders "%n$.." are not supported.
64                         </warning>
65                     </para>
66                 </listitem>
67             </varlistentry>
68             <varlistentry>
69                 <term>a1, ..., an</term>
70                 <listitem>
71                     <para>
72                         Data to be converted and written according to the <varname>format</varname>
73                         argument. Supported types: all numbers, booleans, strings. Only the real part
74                         of complex numbers is considered (current Scilab limitation).
75                     </para>
76                 </listitem>
77             </varlistentry>
78         </variablelist>
79     </refsection>
80     <refsection>
81         <title>Описание</title>
82         <para>
83             <literal>mfprintf(fd, format, a1, a2, ..)</literal> replaces placeholders provided
84             in the <varname>format</varname> string with values of <varname>a1</varname>,
85             <varname>a2</varname>, .. converted according to each respective placeholder directive,
86             and writes the result to the file specified by its index <varname>fd</varname>.
87         </para>
88         <para>
89             If <varname>a1</varname>, <varname>a2</varname>, .. are arrays with multiple rows,
90             they feed the format row by row: the format is used iteratively for every row of the
91             (horizontally "concatenated") arrays, until the bottom
92             of the least tall array is reached. Remaining rows of taller arrays (if any) are ignored.
93             See examples.
94         </para>
95         <para>
96             If the total number of columns of <varname>a1</varname>, <varname>a2</varname>, ..
97             is bigger than the number of placeholders in the <varname>format</varname>,
98             then extra columns are ignored. If it is smaller, an error is yielded.
99         </para>
100         <para>
101             Функция <literal>mfprintf</literal> является интерфейсом для версии функции <literal>fprintf</literal> на языке C.
102         </para>
103     </refsection>
104     <refsection>
105         <title>Примеры</title>
106         <programlisting role="example"><![CDATA[
107 fd = mopen(TMPDIR+'/text.txt','wt');
108 mfprintf(fd,'Привет, %s %d.\n','мир!',1);
109 mfprintf(fd,'Привет, %s %d.\n','Scilab',2);
110 mfprintf(fd,'Эта строка построена с помощью вектор-столбца (26:28) %d.\n',[26:28].');
111 mfprintf(fd,'Эта строка построена с помощью вектор-строки (26:28) %d.\n',[26:28]);
112 A = rand(3,6);
113 mfprintf(fd,'Эта строка построена с помощью матрицы %.3f.\n',A);
114 mclose(fd);
115 editor(TMPDIR+'/text.txt')
116
117 mfprintf(0,'stderr output.\n');
118 mfprintf(6,'stdout output.\n');
119      ]]></programlisting>
120         <para/>
121         <programlisting role="example"><![CDATA[
122 I = (1:4)';
123 A = [26.93 ; 63.25 ; 40.51 ; 91.84];
124 B = [ 3.62 ; 15.04 ; 25.3  ; 48.19];
125 C = [ 4.37   28.06
126      48.18   %inf
127      41.48   %nan
128      26.39   77.83];
129 Status = ["NOK" "NOK" "NOK" "OK"]';
130 Format = "Iteration %d: Results: A= %f   B= %2d%%  Status= %3s   C(1)= %g  C(2)= %e\n";
131 File = TMPDIR + "/mfprintf.txt";
132 fd = mopen(File, 'wt');
133 mfprintf(fd, Format, I, A, B, Status, C);
134 mclose
135 editor(File)
136      ]]></programlisting>
137         <screen><![CDATA[
138 Iteration 1: Results: A= 26.930000   B=  3%  Status= NOK   C(1)= 4.37  C(2)= 2.806000e+01
139 Iteration 2: Results: A= 63.250000   B= 15%  Status= NOK   C(1)= 48.18  C(2)= Inf
140 Iteration 3: Results: A= 40.510000   B= 25%  Status= NOK   C(1)= 41.48  C(2)= Nan
141 Iteration 4: Results: A= 91.840000   B= 48%  Status=  OK   C(1)= 26.39  C(2)= 7.783000e+01
142 ]]></screen>
143         <para/>
144         <para>
145             Supernumerary columns or rows are ignored:
146         </para>
147         <programlisting role="example"><![CDATA[
148 A = [%T  %F  %T  %T  %F]';
149 B = [ 4.37   28.06
150      48.18   %inf
151      41.48   %nan ];
152 File = TMPDIR + "/mfprintf.txt";
153 fd = mopen(File, 'wt');
154 mfprintf(fd, "OK? %s  Value: %4.1f\n", A, B)
155 mclose
156 editor(File)
157      ]]></programlisting>
158         <screen><![CDATA[
159 OK? T  Value:  4.4
160 OK? F  Value: 48.2
161 OK? T  Value: 41.5
162 ]]></screen>
163     </refsection>
164     <refsection role="see also">
165         <title>Смотрите также</title>
166         <simplelist type="inline">
167             <member>
168                 <link linkend="printf_conversion">printf_conversion</link>
169             </member>
170             <member>
171                 <link linkend="csvWrite">csvWrite</link>
172             </member>
173             <member>
174                 <link linkend="fprintfMat">fprintfMat</link>
175             </member>
176             <member>
177                 <link linkend="write">write</link>
178             </member>
179             <member>
180                 <link linkend="mputl">mputl</link>
181             </member>
182             <member>
183                 <link linkend="mputstr">mputstr</link>
184             </member>
185             <member>
186                 <link linkend="mopen">mopen</link>
187             </member>
188             <member>
189                 <link linkend="mclose">mclose</link>
190             </member>
191             <member>
192                 <link linkend="mprintf">msprintf</link>
193             </member>
194             <member>
195                 <link linkend="mfscanf">mfscanf</link>
196             </member>
197         </simplelist>
198     </refsection>
199     <refsection role="history">
200         <title>История</title>
201         <revhistory>
202             <revision>
203                 <revnumber>6.1.1</revnumber>
204                 <revdescription>
205                     Input data can be boolean.
206                 </revdescription>
207             </revision>
208         </revhistory>
209     </refsection>
210 </refentry>