scilab/modules/fileio/help/ru_RU/scanf_conversion.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="scanf_conversion">
  15     <refnamediv>
  16         <refname>преобразование scanf</refname>
  17         <refpurpose>
  18             спецификации преобразования mscanf, msscanf, mfscanf
  19         </refpurpose>
  20     </refnamediv>
  21     <refsection>
  22         <title>Описание</title>
  23         <para>
  24             Каждая спецификация преобразования в параметре <varname>format</varname> содержит следующие элементы:
  25         </para>
  26         <itemizedlist>
  27             <listitem>
  28                 <para>
  29                     символ <literal>%</literal> (знак "процент");
  30                 </para>
  31             </listitem>
  32             <listitem>
  33                 <para>
  34                     необязательный символ подавления присвоения <literal>*</literal> ("звёздочка");
  35                 </para>
  36             </listitem>
  37             <listitem>
  38                 <para>
  39                     необязательное числовое значение максимальной ширины поля;
  40                 </para>
  41             </listitem>
  42             <listitem>
  43                 <para>
  44                     код преобразования.
  45                 </para>
  46             </listitem>
  47         </itemizedlist>
  48         <para>
  49             Спецификация преобразования имеет следующий синтаксис:
  50         </para>
  51         <para>
  52             <literal>[*][ширина][размер]код_преобразования</literal>.
  53         </para>
  54         <para>
  55             Результаты преобразования помещаются в аргументы <varname>v_i</varname> если вы не укажете подавление присвоения с помощью символа <literal>*</literal> ("звёздочка"). Подавления присвоения предоставляет способ описать входное поле, которое следует пропустить. Входное поле является строкой символов-непробелов. Оно простирается до ближайшего некорректного символа или до тех пор, пока ширина поля, если она указана, не кончится.
  56         </para>
  57         <para>
  58             Код преобразования указывает как интерпретировать входное поле. Вам не нужно указывать параметр <varname>v_i</varname> для подавленного поля. Вы можете использовать следующие коды преобразования:
  59         </para>
  60         <variablelist>
  61             <varlistentry>
  62                 <term>%</term>
  63                 <listitem>
  64                     <para>
  65                         принимает отдельный символ <literal>%</literal> (знак "процент"), вводимый в этом месте; присвоение не делается.
  66                     </para>
  67                 </listitem>
  68             </varlistentry>
  69             <varlistentry>
  70                 <term>d, i</term>
  71                 <listitem>
  72                     <para>принимает десятичное целое число.</para>
  73                 </listitem>
  74             </varlistentry>
  75             <varlistentry>
  76                 <term>u</term>
  77                 <listitem>
  78                     <para>принимает беззнаковое десятичное целое число.</para>
  79                 </listitem>
  80             </varlistentry>
  81             <varlistentry>
  82                 <term>o</term>
  83                 <listitem>
  84                     <para>принимает восьмеричное целое число.</para>
  85                 </listitem>
  86             </varlistentry>
  87             <varlistentry>
  88                 <term>x</term>
  89                 <listitem>
  90                     <para>принимает шестнадцатеричное целое число.</para>
  91                 </listitem>
  92             </varlistentry>
  93             <varlistentry>
  94                 <term>e, f, g</term>
  95                 <listitem>
  96                     <para>
  97                         принимает число с плавающей запятой. Следующее поле преобразуется соответствующим образом и сохраняется через соответствующий параметр, который должен быть указателем на число с плавающей запятой. Формат ввода для чисел с плавающей запятой является строкой цифр со следующими необязательными характеристиками:
  98                     </para>
  99                     <itemizedlist>
 100                         <listitem>
 101                             <para>
 102                                 это может быть значение со знаком;
 103                             </para>
 104                         </listitem>
 105                         <listitem>
 106                             <para>
 107                                 это может быть экспоненциальное значение, содержащее десятичную запятую, за которой следует экспоненциальное поле, которое состоит из <literal>E</literal> или <literal>e</literal>, за которым следует целое число (может быть со знаком);
 108                             </para>
 109                         </listitem>
 110                         <listitem>
 111                             <para>
 112                                 это может быть одно из специальных значений <constant>%inf</constant>, <constant>%nan</constant>.
 113                             </para>
 114                         </listitem>
 115                     </itemizedlist>
 116                 </listitem>
 117             </varlistentry>
 118             <varlistentry>
 119                 <term>s</term>
 120                 <listitem>
 121                     <para>принимает строку символов;</para>
 122                 </listitem>
 123             </varlistentry>
 124             <varlistentry>
 125                 <term>c</term>
 126                 <listitem>
 127                     <para>
 128                         ожидается символьное значение. Нормальный пропуск пробела подавляется.
 129                     </para>
 130                 </listitem>
 131             </varlistentry>
 132             <varlistentry>
 133                 <term>%lg</term>
 134                 <listitem>
 135                     <para>получает значение в виде числа удвоенной точности (double).</para>
 136                 </listitem>
 137             </varlistentry>
 138         </variablelist>
 139     </refsection>
 140     <refsection role="see also">
 141         <title>Смотрите также</title>
 142         <simplelist type="inline">
 143             <member>
 144                 <link linkend="scanf">mcscanf</link>
 145             </member>
 146             <member>
 147                 <link linkend="printf_conversion">преобразование printf</link>
 148             </member>
 149         </simplelist>
 150     </refsection>
 151 </refentry>
 152