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