6d9ed773173895a0d0098db90537b3a505a14a38
[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  *
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:ns5="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="mfprintf" xml:lang="ru">
18     <refnamediv>
19         <refname>mfprintf</refname>
20         <refpurpose>преобразует, форматирует и записывает данные в файл</refpurpose>
21     </refnamediv>
22     <refsynopsisdiv>
23         <title>Синтаксис</title>
24         <synopsis>mfprintf(fd, format, a1, ..., an);</synopsis>
25     </refsynopsisdiv>
26     <refsection>
27         <title>Аргументы</title>
28         <variablelist>
29             <varlistentry>
30                 <term>fd</term>
31                 <listitem>
32                     <para>
33                         скаляр, файловый дескриптор, предоставленный с помощью
34                         <function>mopen</function> (это положительное число).
35                     </para>
36                     <para>
37                         Если <varname>fd</varname> равен 0, то перенаправление в
38                         стандартное устройство вывода сообщений об ошибках (stderr).
39                     </para>
40                     <para>
41                         Если <varname>fd</varname> равен 6, то перенаправление в
42                         стандартное устройство вывода (stdout).
43                     </para>
44                     <para>
45                         УСТАРЕЛО: значение <literal>-1</literal> относится к файлу по
46                         умолчанию (т. е. последнему открытому файлу).
47                     </para>
48                 </listitem>
49             </varlistentry>
50             <varlistentry>
51                 <term>format</term>
52                 <listitem>
53                     <para>
54                         Scilab-строка, описывающая формат, который нужно использовать для
55                         записи оставшихся операндов. Операнд <varname>format</varname>
56                         следует как можно ближе к синтаксису операндов формата
57                         <function>printf</function> в языке C.
58                     </para>
59                 </listitem>
60             </varlistentry>
61             <varlistentry>
62                 <term>str</term>
63                 <listitem>
64                     <para>
65                         символьная строка: строка, которую нужно отсканировать.
66                     </para>
67                 </listitem>
68             </varlistentry>
69             <varlistentry>
70                 <term>a1, ..., an</term>
71                 <listitem>
72                     <para>
73                         данные, которые преобразуются и распечатываются в соответствии с параметром формата.
74                     </para>
75                 </listitem>
76             </varlistentry>
77         </variablelist>
78     </refsection>
79     <refsection>
80         <title>Описание</title>
81         <para>
82             Функция <function>mfprintf</function> является интерфейсом для версии функции <function>fprintf</function> на языке C.
83         </para>
84         <para>
85             Функция <function>mfprintf</function> записывает форматированные
86             операнды в файл, указанный файловым дескриптором <varname>fd</varname>.
87             Операнды аргумента форматируются по управлением операнда
88             <varname>format</varname>.
89         </para>
90         <para>
91             Эта функция может быть использована для вывода векторов-столбцов чисел и
92             строковых векторов без явных циклов по элементам. В этом случае функция
93             проводит итерации по строкам. Наиболее короткий вектор даёт количество раз, сколько формат будет повторён.
94         </para>
95         <para>
96             Однородная последовательность параметров одинакового типа может быть
97             заменена матрицей.
98         </para>
99     </refsection>
100     <refsection>
101         <title>Примеры</title>
102         <programlisting role="example"><![CDATA[
103
104 fd = mopen(TMPDIR+'/text.txt','wt');
105 mfprintf(fd,'Привет, %s %d.\n','мир!',1);
106 mfprintf(fd,'Привет, %s %d.\n','Scilab',2);
107 mfprintf(fd,'Эта строка построена с помощью вектор-столбца (26:28) %d.\n',[26:28].');
108 mfprintf(fd,'Эта строка построена с помощью вектор-строки (26:28) %d.\n',[26:28]);
109 A = rand(3,6);
110 mfprintf(fd,'Эта строка построена с помощью матрицы %.3f.\n',A);
111 mclose(fd);
112 if (isdef('editor') | (funptr('editor')<>0)) then
113   editor(TMPDIR+'/text.txt')
114 end
115 mfprintf(0,'stderr output.\n');
116 mfprintf(6,'stdout output.\n');
117  ]]></programlisting>
118     </refsection>
119     <refsection role="see also">
120         <title>Смотрите также</title>
121         <simplelist type="inline">
122             <member>
123                 <link linkend="mclose">mclose</link>
124             </member>
125             <member>
126                 <link linkend="meof">meof</link>
127             </member>
128             <member>
129                 <link linkend="fprintfMat">fprintfMat</link>
130             </member>
131             <member>
132                 <link linkend="mfscanf">mfscanf</link>
133             </member>
134             <member>
135                 <link linkend="fscanfMat">fscanfMat</link>
136             </member>
137             <member>
138                 <link linkend="mget">mget</link>
139             </member>
140             <member>
141                 <link linkend="mgetstr">mgetstr</link>
142             </member>
143             <member>
144                 <link linkend="mopen">mopen</link>
145             </member>
146             <member>
147                 <link linkend="mprintf">mprintf</link>
148             </member>
149             <member>
150                 <link linkend="mput">mput</link>
151             </member>
152             <member>
153                 <link linkend="mputstr">mputstr</link>
154             </member>
155             <member>
156                 <link linkend="mseek">mseek</link>
157             </member>
158             <member>
159                 <link linkend="mtell">mtell</link>
160             </member>
161             <member>
162                 <link linkend="mdelete">mdelete</link>
163             </member>
164             <member>
165                 <link linkend="printf_conversion">преобразование в printf</link>
166             </member>
167         </simplelist>
168     </refsection>
169 </refentry>
170