scanf/printf_conversion documentation corrected.
[scilab.git] / 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.1-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="msscanf">msscanf</link>
145             </member>
146             <member>
147                 <link linkend="mfscanf">mfscanf</link>
148             </member>
149             <member>
150                 <link linkend="mscanf">mscanf</link>
151             </member>
152             <member>
153                 <link linkend="printf_conversion">преобразование printf</link>
154             </member>
155         </simplelist>
156     </refsection>
157 </refentry>
158