Fix typos in help pages of module fileio (en_US, ru_RU)
[scilab.git] / scilab / modules / fileio / help / ru_RU / mput.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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" version="5.0-subset Scilab" xml:lang="ru" xml:id="mput">
15     <refnamediv>
16         <refname>mput</refname>
17         <refpurpose>
18             записывает байт или слово в заданном двоичном формате
19         </refpurpose>
20     </refnamediv>
21     <refsynopsisdiv>
22         <title>Последовательность вызова</title>
23         <synopsis>mput(x [, type, fd])</synopsis>
24     </refsynopsisdiv>
25     <refsection>
26         <title>Аргументы</title>
27         <variablelist>
28             <varlistentry>
29                 <term>x</term>
30                 <listitem>
31                     <para>
32                         вектор целых чисел или чисел с плавающей запятой.
33                     </para>
34                 </listitem>
35             </varlistentry>
36             <varlistentry>
37                 <term>fd</term>
38                 <listitem>
39                     <para>
40                         скаляр: дескриптор файла, возвращённый функцией 
41                         <function>mopen</function>.  Значение по умолчанию равно -1, 
42                         что означает последний файл, открытый функцией 
43                         <function>mopen</function>.
44                     </para>
45                 </listitem>
46             </varlistentry>
47             <varlistentry>
48                 <term>type</term>
49                 <listitem>
50                     <para>
51                         строка: двоичный формат, используемый для записи всех элементов   <varname>x</varname>.
52                     </para>
53                 </listitem>
54             </varlistentry>
55         </variablelist>
56     </refsection>
57     <refsection>
58         <title>Описание</title>
59         <para>
60             Функция <function>mput</function> записывает данные в выход, 
61             определённый параметром потока <varname>fd</varname>. Данные 
62             записываются в место, на которое в данный момент указывает указатель 
63             положения в файле, и передвигает указатель дальше соответствующим
64             образом.
65         </para>
66         <para>
67             Параметр <varname>type</varname> -- это определитель преобразования, который может быть установлен любым из следующих символов (значение по умолчанию <literal>"l"</literal>):
68         </para>
69         <variablelist>
70             <varlistentry>
71                 <term>"l", "i", "s", "ul", "ui", "us", "d", "f", "c", "uc"</term>
72                 <listitem>
73                     <para>
74                         для записи соответственно типов long, int, short, unsigned long, unsigned int, unsigned short, double, float, char и unsigned char. Байты, которые записываются, автоматически переставляются, если нужно (это проверяется статусом прямого порядка байтов) для того, чтобы сделать двоичные файлы, независимые от машины. Режим перестановки байтов по умолчанию может быть подавлен добавлением флага <code>swap = 0</code> в функции <function>mopen</function>.
75                     </para>
76                 </listitem>
77             </varlistentry>
78             <varlistentry>
79                 <term>"..l" или "..b"</term>
80                 <listitem>
81                     <para>
82                         Можно также записывать в режиме обратной и прямой последовательности байтов, добавляя символ <literal>"l"</literal> или <literal>"b"</literal> в конец указателя типа <varname>type</varname>. Например,
83                         <literal>"db"</literal> будет записывать тип double в режиме обратного порядка байтов.
84                     </para>
85                 </listitem>
86             </varlistentry>
87         </variablelist>
88     </refsection>
89     <refsection>
90         <title>Примеры</title>
91         <programlisting role="example"><![CDATA[ 
92 filen = 'test.bin';
93 mopen(filen,'wb');
94 mput(1996,'l');mput(1996,'i');mput(1996,'s');mput(98,'c');
95  
96 // force little-endian 
97 mput(1996,'ll');mput(1996,'il');mput(1996,'sl');mput(98,'cl');
98  
99 // force big-endian 
100 mput(1996,'lb');mput(1996,'ib');mput(1996,'sb');mput(98,'cb');
101  
102 mclose();
103 mopen(filen,'rb');
104 if 1996<>mget(1,'l') then pause,end
105 if 1996<>mget(1,'i') then pause,end
106 if 1996<>mget(1,'s') then pause,end
107 if   98<>mget(1,'c') then pause,end
108  
109 // force little-endian
110 if 1996<>mget(1,'ll') then pause,end
111 if 1996<>mget(1,'il') then pause,end
112 if 1996<>mget(1,'sl') then pause,end
113 if   98<>mget(1,'cl') then pause,end
114  
115 // force big-endian 
116 if 1996<>mget(1,'lb') then pause,end
117 if 1996<>mget(1,'ib') then pause,end
118 if 1996<>mget(1,'sb') then pause,end
119 if   98<>mget(1,'cb') then pause,end
120  
121 mclose();
122  ]]></programlisting>
123     </refsection>
124     <refsection role="see also">
125         <title>Смотрите также</title>
126         <simplelist type="inline">
127             <member>
128                 <link linkend="mclose">mclose</link>
129             </member>
130             <member>
131                 <link linkend="meof">meof</link>
132             </member>
133             <member>
134                 <link linkend="mfprintf">mfprintf</link>
135             </member>
136             <member>
137                 <link linkend="fprintfMat">fprintfMat</link>
138             </member>
139             <member>
140                 <link linkend="mfscanf">mfscanf</link>
141             </member>
142             <member>
143                 <link linkend="fscanfMat">fscanfMat</link>
144             </member>
145             <member>
146                 <link linkend="mget">mget</link>
147             </member>
148             <member>
149                 <link linkend="mgetl">mgetl</link>
150             </member>
151             <member>
152                 <link linkend="mgetstr">mgetstr</link>
153             </member>
154             <member>
155                 <link linkend="mopen">mopen</link>
156             </member>
157             <member>
158                 <link linkend="mprintf">mprintf</link>
159             </member>
160             <member>
161                 <link linkend="mputl">mputl</link>
162             </member>
163             <member>
164                 <link linkend="mputstr">mputstr</link>
165             </member>
166             <member>
167                 <link linkend="mseek">mseek</link>
168             </member>
169             <member>
170                 <link linkend="mtell">mtell</link>
171             </member>
172             <member>
173                 <link linkend="mdelete">mdelete</link>
174             </member>
175         </simplelist>
176     </refsection>
177 </refentry>
178