Fix some typos
[scilab.git] / scilab / modules / fileio / help / ru_RU / mseek.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" xmlns:scilab="http://www.scilab.org" xml:lang="ru" xml:id="mseek">
15     <refnamediv>
16         <refname>mseek</refname>
17         <refpurpose>устанавливает текущую позицию в двоичном файле</refpurpose>
18     </refnamediv>
19     <refsynopsisdiv>
20         <title>Последовательность вызова</title>
21         <synopsis>mseek(n [,fd, flag])</synopsis>
22     </refsynopsisdiv>
23     <refsection>
24         <title>Аргументы</title>
25         <variablelist>
26             <varlistentry>
27                 <term>n</term>
28                 <listitem>
29                     <para>
30                         положительный скаляр: смещение от исходного положения в количестве байтов.
31                     </para>
32                 </listitem>
33             </varlistentry>
34             <varlistentry>
35                 <term>fd</term>
36                 <listitem>
37                     <para>
38                         скаляр: дескриптор файла, возвращённый функцией <function>mopen</function>. <literal>-1</literal> 
39                         указывает на последний открытый файл. Значение по умолчанию равно <literal>-1</literal>.
40                     </para>
41                 </listitem>
42             </varlistentry>
43             <varlistentry>
44                 <term>flag</term>
45                 <listitem>
46                     <para>
47                         строка: определяет исходное положение. Значение по умолчанию -- 
48                         <literal>'set'</literal>.
49                     </para>
50                 </listitem>
51             </varlistentry>
52         </variablelist>
53     </refsection>
54     <refsection>
55         <title>Описание</title>
56         <para>
57             Функция <function>mseek</function> устанавливает положение следующей 
58             операции ввода или вывода потока <varname>fd</varname>. Новое 
59             положение находится на расстоянии (со знаком), указанном в 
60             <varname>n</varname> байт от начала, от текущего положения или от 
61             конца файла в соответствии со значением <varname>flag</varname>, 
62             которое может быть <literal>'set'</literal>, <literal>'cur'</literal> 
63             или <literal>'end'</literal>.
64         </para>
65         <para>
66             Функция <function>mseek</function> позволяет индикатору положения в 
67             файле быть установленным за пределами конца существующих данных  в 
68             файле. Если данные будут позднее записаны в это место, то последующее 
69             чтение этих данных в пропущенном месте будет возвращать ноль до тех 
70             пор, пока данные не будут действительно записаны в пропущенное место. 
71             Функция <function>mseek</function> сама по себе не увеличивает
72             размер файла.
73         </para>
74     </refsection>
75     <refsection>
76         <title>Примеры</title>
77         <programlisting role="example"><![CDATA[ 
78 file3=fullfile(TMPDIR,'test3.bin');
79 fd1= mopen(file3,'wb');
80 for i=1:10
81   mput(i,'d');
82 end 
83 mseek(0);
84 mput(678,'d');
85 mseek(0,fd1,'end');
86 mput(932,'d');
87 mclose(fd1)
88  
89 fd1= mopen(file3,'rb');
90 res=mget(11,'d')
91 res1=[1:11]; res1(1)=678;res1($)=932;
92 if res1<>res then
93   write(%io(2),'Ошибка в программе');
94 end
95 mseek(0,fd1,'set');
96  
97 // попытка чтения данных более, чем сохранено
98 res1=mget(100,'d',fd1);
99 if res1<>res then
100   write(%io(2),'Ошибка в программе');
101 end
102 meof(fd1)
103 mclearerr(fd1)
104 mclose(fd1);
105  ]]></programlisting>
106     </refsection>
107     <refsection role="see also">
108         <title>Смотрите также</title>
109         <simplelist type="inline">
110             <member>
111                 <link linkend="mclose">mclose</link>
112             </member>
113             <member>
114                 <link linkend="meof">meof</link>
115             </member>
116             <member>
117                 <link linkend="mfprintf">mfprintf</link>
118             </member>
119             <member>
120                 <link linkend="fprintfMat">fprintfMat</link>
121             </member>
122             <member>
123                 <link linkend="mfscanf">mfscanf</link>
124             </member>
125             <member>
126                 <link linkend="fscanfMat">fscanfMat</link>
127             </member>
128             <member>
129                 <link linkend="mget">mget</link>
130             </member>
131             <member>
132                 <link linkend="mgetstr">mgetstr</link>
133             </member>
134             <member>
135                 <link linkend="mopen">mopen</link>
136             </member>
137             <member>
138                 <link linkend="mprintf">mprintf</link>
139             </member>
140             <member>
141                 <link linkend="mput">mput</link>
142             </member>
143             <member>
144                 <link linkend="mputstr">mputstr</link>
145             </member>
146             <member>
147                 <link linkend="mtell">mtell</link>
148             </member>
149             <member>
150                 <link linkend="mdelete">mdelete</link>
151             </member>
152         </simplelist>
153     </refsection>
154 </refentry>
155