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