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