scanf/printf_conversion documentation corrected.
[scilab.git] / scilab / modules / fileio / help / ja_JP / 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="ja" xml:id="scanf_conversion">
15     <refnamediv>
16         <refname>scanf_conversion</refname>
17         <refpurpose>scanf, msscanf, mfscanf 変換指定子</refpurpose>
18     </refnamediv>
19     <refsection>
20         <title>説明</title>
21         <para>
22             formatパラメータの各変換指定子には以下の要素が含まれます:
23         </para>
24         <variablelist>
25             <varlistentry>
26                 <term>+</term>
27                 <listitem>
28                     <para>% 文字(パーセント記号)</para>
29                 </listitem>
30             </varlistentry>
31             <varlistentry>
32                 <term>+</term>
33                 <listitem>
34                     <para>代入禁止文字 * (オプション)</para>
35                 </listitem>
36             </varlistentry>
37             <varlistentry>
38                 <term>+</term>
39                 <listitem>
40                     <para>数値の最大フィールド幅 (オプション)</para>
41                 </listitem>
42             </varlistentry>
43             <varlistentry>
44                 <term>+</term>
45                 <listitem>
46                     <para>変換コード</para>
47                 </listitem>
48             </varlistentry>
49         </variablelist>
50         <para>
51             変換指定子は以下のような構文となります:
52         </para>
53         <para>
54             <literal>[*][width][size]convcode</literal>.
55         </para>
56         <para>
57             変換の結果は,代入禁止を * (アスタリスク)で指定しない限り,
58             v_i 引数に代入されます.
59             代入禁止により入力フィールドをスキップできるようになります.
60             入力フィールドは非空白文字の文字列です.
61             次の不適切な文字まで,またはフィールド幅が指定された場合には
62             これがあふれた場合に拡張されます.
63         </para>
64         <para>
65             変換コードは入力フィールドの解釈の方法を指定します.
66             代入禁止されたフィールドの v_i パラメータを指定する
67             必要はありません.
68             以下の変換コードを使用することが可能です:
69         </para>
70         <variablelist>
71             <varlistentry>
72                 <term>%</term>
73                 <listitem>
74                     <para>
75                         ここまでは1個の% (パーセント記号)入力; 代入は行われません.
76                     </para>
77                 </listitem>
78             </varlistentry>
79             <varlistentry>
80                 <term>d, i</term>
81                 <listitem>
82                     <para>10進整数を入力;</para>
83                 </listitem>
84             </varlistentry>
85             <varlistentry>
86                 <term>u</term>
87                 <listitem>
88                     <para>符号なしの10進整数を入力;</para>
89                 </listitem>
90             </varlistentry>
91             <varlistentry>
92                 <term>o</term>
93                 <listitem>
94                     <para>8進整数を入力;</para>
95                 </listitem>
96             </varlistentry>
97             <varlistentry>
98                 <term>x</term>
99                 <listitem>
100                     <para>16進整数を入力;</para>
101                 </listitem>
102             </varlistentry>
103             <varlistentry>
104                 <term>e,f,g</term>
105                 <listitem>
106                     <para>
107                         浮動小数点数を入力.
108                         次のフィールドは同時に変換され,
109                         対応するパラメータは保存されます.これは,
110                         float へのポインタである必要があります.
111                         浮動小数点数の入力形式は数値の文字列で,以下のオプションの文字を
112                         指定できます:
113                     </para>
114                 </listitem>
115             </varlistentry>
116             <varlistentry>
117                 <term>+</term>
118                 <listitem>
119                     <para>符号付きの値とすることができます.</para>
120                 </listitem>
121             </varlistentry>
122             <varlistentry>
123                 <term>+</term>
124                 <listitem>
125                     <para>
126                         小数点の後に指数フィールドが続く,
127                         指数の値とすることができます.
128                         指数フィールドは E または e の後に整数(オプションで符号付き)
129                         が続く形式となります.
130                     </para>
131                 </listitem>
132             </varlistentry>
133             <varlistentry>
134                 <term>+</term>
135                 <listitem>
136                     <para>特殊な値INF, NaN,のどれかを指定できます</para>
137                 </listitem>
138             </varlistentry>
139             <varlistentry>
140                 <term>s</term>
141                 <listitem>
142                     <para>文字列を入力.</para>
143                 </listitem>
144             </varlistentry>
145             <varlistentry>
146                 <term>c</term>
147                 <listitem>
148                     <para>文字を入力. 空白文字のスキップ処理は禁止されます.</para>
149                 </listitem>
150             </varlistentry>
151             <varlistentry>
152                 <term>%lg</term>
153                 <listitem>
154                     <para>doubleとして値を取得.</para>
155                 </listitem>
156             </varlistentry>
157         </variablelist>
158     </refsection>
159     <refsection role="see also">
160         <title>参照</title>
161         <simplelist type="inline">
162             <member>
163                 <link linkend="msscanf">msscanf</link>
164             </member>
165             <member>
166                 <link linkend="mfscanf">mfscanf</link>
167             </member>
168             <member>
169                 <link linkend="mscanf">mscanf</link>
170             </member>
171             <member>
172                 <link linkend="printf_conversion">printf_conversion</link>
173             </member>
174         </simplelist>
175     </refsection>
176 </refentry>