f98ca0e177f761265b757702b166380353027b4a
[scilab.git] / scilab / modules / output_stream / help / ja_JP / printf_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) XXXX-2008 - INRIA
5  *
6  * Copyright (C) 2012 - 2016 - Scilab Enterprises
7  *
8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
10  * This file was originally licensed under the terms of the CeCILL v2.1,
11  * and continues to be available under such terms.
12  * For more information, see the COPYING file which you should have received
13  * along with this program.
14  *
15  -->
16 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="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="printf_conversion" xml:lang="ja">
17     <refnamediv>
18         <refname>printf_conversion</refname>
19         <refpurpose>mprintf, msprintf, mfprintf 変換仕様</refpurpose>
20     </refnamediv>
21     <refsection>
22         <title>説明</title>
23         <para>
24             <literal>mprintf</literal> ,
25             <literal>msprintf</literal> , <literal>mfprintf</literal>における各変換仕様.
26             <literal>format</literal> パラメータは以下のような構文を有します:
27         </para>
28         <itemizedlist>
29             <listitem>
30                 <para>A % (パーセント) 符号.</para>
31             </listitem>
32             <listitem>
33                 <para>
34                     0個以上の <literal>options</literal>で,
35                     変換仕様の意味を修正します.
36                     以下のリストに<literal>option</literal>文字とその意味を示します:
37                 </para>
38                 <itemizedlist>
39                     <listitem>
40                         <para>- : 左揃え, フィールド内では, 変換の結果.</para>
41                     </listitem>
42                     <listitem>
43                         <para>+ : (+または -)を指定する符号変換の結果を開始.</para>
44                     </listitem>
45                     <listitem>
46                         <para>'空白' :
47                             符号変換後の最初の文字が符号ではない場合に結果の
48                             前に空白文字を付加します.
49                             (空白) および +オプションが共に指定された場合,
50                             (空白) オプションは無視されます.
51                         </para>
52                     </listitem>
53                     <listitem>
54                         <para># : 別の形式に値を変換.
55                             <literal>c</literal>, <literal>d</literal>, <literal>i</literal>,
56                             <literal>s</literal>, および <literal>u</literal> 変換の場合,
57                             <literal>#</literal>オプションの効果はありません.
58                             <literal>o</literal> 変換の場合, <literal>#</literal> は
59                             結果の最初の桁を強制的に0 (ゼロ)にし,精度を増加させます.
60                             <literal>x</literal> および <literal>X</literal>変換の場合,
61                             ゼロでない結果の前に0xまたは0Xが付加されます.
62                             <literal>e, E, f, g,</literal> および <literal>G</literal>変換の場合,
63                             小数点以下の値がない場合でも結果には常に小数点が含まれます.
64                             <literal>g</literal> および
65                             <literal>G</literal> 変換の場合,
66                             末尾の0は結果から除かれません.
67                         </para>
68                     </listitem>
69                     <listitem>
70                         <para>0 :
71                             <literal>d</literal>,
72                             <literal>i</literal>, <literal>o</literal>, <literal>u</literal>,
73                             <literal>x</literal>, <literal>X</literal>, <literal>e</literal>,
74                             <literal>E</literal>, <literal>f</literal>, <literal>g</literal>,
75                             および <literal>G</literal>変換において
76                             (符号または基底の指示子の後に)
77                             前に0をつけることによりフィールド幅内を埋めます:
78                             空白によるパディングは行われません
79                             <literal>0</literal> および <literal>\-</literal>(ダッシュ)が共に指定された場合,
80                             <literal>0</literal>フラグは無視されます.
81                             <literal>d</literal>, <literal>i</literal>,
82                             <literal>o</literal> <literal>u</literal>, <literal>x</literal>,
83                             および <literal>X</literal> 変換の場合, 精度が指定されると,
84                             <literal>0</literal> フラグも無視されます.
85                         </para>
86                     </listitem>
87                 </itemizedlist>
88             </listitem>
89         </itemizedlist>
90         <para>
91             オプションの10進数文字列は
92             最小フィールド幅を指定します.
93             変換された値の文字がこのフィールド幅よりも少ない場合,
94             フィールドはフィールド幅の指定長まで左側にパディングされます.
95             左寄せオプションが指定された場合,
96             フィールドは右側にパディングされます.
97         </para>
98         <para>
99             オプションの精度. 精度は <literal>.</literal> (ドット)の後に
100             10進数文字列が続きます.
101             精度が指定されない場合,
102             このパラメータは 0 (ゼロ)と扱われます.
103             精度指定子:
104         </para>
105         <itemizedlist>
106             <listitem>
107                 <para>
108                     <literal>d</literal>,
109                     <literal>u</literal>, <literal>o</literal>, <literal>x</literal>, または
110                     <literal>X</literal>変換に関する最小表示桁数
111                 </para>
112             </listitem>
113             <listitem>
114                 <para>
115                     <literal>e</literal>, <literal>E</literal>, および <literal>f</literal>
116                     における小数点の後に表示する桁数
117                 </para>
118             </listitem>
119             <listitem>
120                 <para>
121                     <literal>g</literal> および<literal>G</literal>変換における
122                     有効桁の最大値
123                 </para>
124             </listitem>
125             <listitem>
126                 <para>
127                     <literal>s</literal>変換において文字列から出力される
128                     最大文字数
129                 </para>
130             </listitem>
131             <listitem>
132                 <para>適用される変換の種類を示す文字:</para>
133                 <itemizedlist>
134                     <listitem>
135                         <para>% : 変換しません.  %を表示.</para>
136                     </listitem>
137                     <listitem>
138                         <para>
139                             d,i: 整数 <literal>value</literal> を受け取り,
140                             符号付き10進数表記に変換します.
141                             精度は表示される最小の桁数を指定します.
142                             変換される値がより少ない桁数で表せる場合,
143                             前にゼロを付加して拡張されます.
144                             デフォルトの精度は1です.値0を精度0で変換した結果は,
145                             ヌル文字列となります.
146                             前に付加する文字をゼロとしてフィールド幅を指定すると,
147                             フィールド幅までの値では前にゼロを付加するパディングが
148                             行われます.
149                         </para>
150                     </listitem>
151                     <listitem>
152                         <para>
153                             u : 整数 <literal>value</literal> を受け取り,
154                             符号なし10進数表記に変換します.
155                             精度は表示される最小の桁数を指定します.
156                             変換される値がより少ない桁数で表せる場合,
157                             前にゼロを付加して拡張されます.
158                             デフォルトの精度は1です.値0を精度0で変換した結果は,
159                             ヌル文字列となります.
160                             前に付加する文字をゼロとしてフィールド幅を指定すると,
161                             フィールド幅までの値では前にゼロを付加するパディングが
162                             行われます.
163                         </para>
164                     </listitem>
165                     <listitem>
166                         <para>
167                             o : 整数 <literal>value</literal> を受け取り,
168                             符号なし8進数表記に変換します.
169                             精度は表示される最小の桁数を指定します.
170                             変換される値がより少ない桁数で表せる場合,
171                             前にゼロを付加して拡張されます.
172                             デフォルトの精度は1です.値0を精度0で変換した結果は,
173                             ヌル文字列となります.
174                             前に付加する文字をゼロとしてフィールド幅を指定すると,
175                             フィールド幅までの値では前にゼロを付加するパディングが
176                             行われます. フィールド幅に8進数を使用することはできません.
177                         </para>
178                     </listitem>
179                     <listitem>
180                         <para>
181                             x, X : 整数 <literal>value</literal> を受け取り,
182                             符号なし16進数表記に変換します.<literal>x</literal>変換では,
183                             文字``abcdef''が使用されます;<literal>X</literal>変換では,
184                             文字``ABCDEF''が使用されます.
185                             精度はは表示される最小の桁数を指定します.
186                             変換される値がより少ない桁数で表せる場合,
187                             前にゼロを付加して拡張されます.
188                             デフォルトの精度は1です.値0を精度0で変換した結果は,
189                             ヌル文字列となります.
190                             前に付加する文字をゼロとしてフィールド幅を指定すると,
191                             フィールド幅までの値では前にゼロを付加するパディングが
192                             行われます.
193                         </para>
194                     </listitem>
195                     <listitem>
196                         <para>
197                             f : float または double の<literal>value</literal> を受け取り,
198                             %[\-]<literal>ddd.ddd</literal>形式の10進数表記に変換します.
199                             小数点以下の桁数は,精度指定子に等しくなります.
200                         </para>
201                         <itemizedlist>
202                             <listitem>
203                                 <para>精度が指定されない場合, 6桁が出力されます.</para>
204                             </listitem>
205                             <listitem>
206                                 <para>精度がゼロの場合, 小数点は表示されず,
207                                     システムは<literal>value</literal>に最も近い整数に丸めた数を
208                                     出力します.
209                                 </para>
210                             </listitem>
211                             <listitem>
212                                 <para>小数点が出力される場合,最低でも1桁がその前に出力されます.</para>
213                             </listitem>
214                         </itemizedlist>
215                     </listitem>
216                     <listitem>
217                         <para>
218                             e, E : 実数を受け取り,指数形式%[\-]<literal>d.ddde</literal>+/\-<literal>dd</literal>
219                             に変換します.
220                             小数点の前に1桁があり,小数点の後の桁数は精度指定子に等しくなります.
221                         </para>
222                         <itemizedlist>
223                             <listitem>
224                                 <para>精度が指定されない場合, 6桁が出力されます.</para>
225                             </listitem>
226                             <listitem>
227                                 <para>精度がゼロの場合, 小数点は表示されません.
228                                 </para>
229                             </listitem>
230                             <listitem>
231                                 <para>
232                                     <literal>E</literal> 変換文字の場合,
233                                     指数の前の e の代わりに E を付けた数値を出力します.
234                                     指数には常に2桁以上が含まれます.
235                                     値が 0 の場合, 指数は 0 となります.
236                                 </para>
237                             </listitem>
238                         </itemizedlist>
239                     </listitem>
240                     <listitem>
241                         <para>g, G : 実数を受け取り,有効桁数を指定する精度を付けた
242                             <literal>e</literal>, <literal>E</literal>, または
243                             <literal>f</literal>変換文字の形式に変換します.
244                             末尾のゼロは結果から削除されます.
245                             小数点は数字が続く場合にのみ表示されます.
246                             使用される形式は変換される値に依存します.
247                             変換結果の指数が-4よりも小さい場合,または,
248                             精度より大きいか等しい場合に,
249                             <literal>e</literal> (使用されるフラグが<literal>G</literal>の場合は
250                             <literal>E</literal>)形式が使用されます.
251                         </para>
252                     </listitem>
253                     <listitem>
254                         <para>c : 整数値を受け取り,文字に変換します.</para>
255                     </listitem>
256                     <listitem>
257                         <para>
258                             s : 文字列 <literal>value</literal> を受け取り,
259                             文字列から末尾または精度に示された文字数に達するまで,
260                             文字に変換します.精度が指定されない場合,末尾までの全ての文字が
261                             表示されます.
262                         </para>
263                     </listitem>
264                 </itemizedlist>
265             </listitem>
266         </itemizedlist>
267         <para>フィールド幅または精度は,
268             桁文字の代わりに<literal>*</literal> (アスタリスク)で
269             示すことができます.
270             この場合,整数 <literal>value</literal>パラメータは
271             フィールド幅または精度を指定します.
272             出力に変換される<literal>value</literal> パラメータは
273             変換文字が達するまで取得されません.
274             このため,
275             フィールド幅または精度を指定するパラメータは変換される値よりも
276             前に現れる必要があります.
277         </para>
278         <para>変換の結果がフィールド幅よりも広い場合,
279             このフィールドは変換結果を含められる幅まで拡張されます.
280         </para>
281         <para>
282             +記号の意味は<literal>+</literal>または(空白)整形オプションの
283             どちらが指定されたかに依存します.
284         </para>
285         <para>指数形式 %e の表示はプレットフォームに依存し,
286             指数の桁数は異なります.
287         </para>
288         <informaltable border="1">
289             <tr>
290                 <td>プラットフォーム</td>
291                 <td>例: msprintf("%e",1.23e4)</td>
292             </tr>
293             <tr>
294                 <td>Windows</td>
295                 <td>1.23000e+004</td>
296             </tr>
297             <tr>
298                 <td>Linux/Mac OS</td>
299                 <td>1.23000e+04</td>
300             </tr>
301         </informaltable>
302     </refsection>
303     <refsection>
304         <title>例</title>
305         <programlisting role="example"><![CDATA[
306 mprintf('a string: %s\n', 'Scilab');
307 mprintf('an integer: %d\n', 10);
308 mprintf('an integer: %4d\n', 10);
309 mprintf('a left justified integer: %-4d\n', 10);
310 mprintf('an integer converted to float: %#fd\n',10);
311 mprintf('an integer with a sign: %+4d\n', 10);
312 mprintf('an integer with a sign: %+4d\n', -10);
313 mprintf('an integer padded with zeros: %04d\n', 10);
314 mprintf('an unsigned integer: %u\n', 10);
315 mprintf('an unsigned integer: %4u\n', -10);
316 mprintf('an integer converted to hexadecimal: %x\n', 10);
317 mprintf('a float: %d\n', %pi);
318 mprintf('a float: %3.2d\n', %pi);
319 mprintf('a float (exponential form): %3.2e\n', %pi);
320 mprintf('a float (exponential form): %3.2g\n', %pi);
321 mprintf('a character: %c\n', 'a');
322 mprintf('a character: %c\n', 'aaa');
323  ]]></programlisting>
324     </refsection>
325     <refsection role="see also">
326         <title>参照</title>
327         <simplelist type="inline">
328             <member>
329                 <link linkend="mprintf">mprintf</link>
330             </member>
331             <member>
332                 <link linkend="mfprintf">mfprintf</link>
333             </member>
334             <member>
335                 <link linkend="msprintf">msprintf</link>
336             </member>
337         </simplelist>
338     </refsection>
339 </refentry>