13
13
<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" version="5.0-subset Scilab" xml:id="printf_conversion" xml:lang="ja">
15
<refname>printf_conversion</refname>
16
<refpurpose>mprintf, msprintf, mfprintf 変換仕様</refpurpose>
21
<literal>mprintf</literal> ,
22
<literal>msprintf</literal> , <literal>fprintf</literal>における各変換仕様.
23
<literal>format</literal> パラメータは以下のような構文を有します:
27
<para>A % (パーセント) 符号.</para>
31
0個以上の <literal>options</literal>で,
33
以下のリストに<literal>option</literal>文字とその意味を示します:
37
<para>- : 左揃え, フィールド内では, 変換の結果.</para>
40
<para>+ : (+または -)を指定する符号変換の結果を開始.</para>
44
符号変換後の最初の文字が符号ではない場合に結果の
46
(空白) および +オプションが共に指定された場合,
52
<literal>c</literal>, <literal>d</literal>, <literal>i</literal>,
53
<literal>s</literal>, および <literal>u</literal> 変換の場合,
54
<literal>#</literal>オプションの効果はありません.
55
<literal>o</literal> 変換の場合, <literal>#</literal> は
56
結果の最初の桁を強制的に0 (ゼロ)にし,精度を増加させます.
57
<literal>x</literal> および <literal>X</literal>変換の場合,
58
ゼロでない結果の前に0xまたは0Xが付加されます.
59
<literal>e, E, f, g,</literal> および <literal>G</literal>変換の場合,
60
小数点以下の値がない場合でも結果には常に小数点が含まれます.
61
<literal>g</literal> および
62
<literal>G</literal> 変換の場合,
69
<literal>i</literal>, <literal>o</literal>, <literal>u</literal>,
70
<literal>x</literal>, <literal>X</literal>, <literal>e</literal>,
71
<literal>E</literal>, <literal>f</literal>, <literal>g</literal>,
72
および <literal>G</literal>変換において
74
前に0をつけることによりフィールド幅内を埋めます:
76
<literal>0</literal> および <literal>\-</literal>(ダッシュ)が共に指定された場合,
77
<literal>0</literal>フラグは無視されます.
78
<literal>d</literal>, <literal>i</literal>,
79
<literal>o</literal> <literal>u</literal>, <literal>x</literal>,
80
および <literal>X</literal> 変換の場合, 精度が指定されると,
81
<literal>0</literal> フラグも無視されます.
90
変換された値の文字がこのフィールド幅よりも少ない場合,
91
フィールドはフィールド幅の指定長まで左側にパディングされます.
96
オプションの精度. 精度は <literal>.</literal> (ドット)の後に
99
このパラメータは 0 (ゼロ)と扱われます.
105
<literal>d</literal>,
106
<literal>u</literal>, <literal>o</literal>, <literal>x</literal>, または
107
<literal>X</literal>変換に関する最小表示桁数
112
<literal>e</literal>, <literal>E</literal>, および <literal>f</literal>
118
<literal>g</literal> および<literal>G</literal>変換における
124
<literal>s</literal>変換において文字列から出力される
129
<para>適用される変換の種類を示す文字:</para>
132
<para>% : 変換しません. %を表示.</para>
136
d,i: 整数 <literal>value</literal> を受け取り,
139
変換される値がより少ない桁数で表せる場合,
141
デフォルトの精度は1です.値0を精度0で変換した結果は,
143
前に付加する文字をゼロとしてフィールド幅を指定すると,
144
フィールド幅までの値では前にゼロを付加するパディングが
150
u : 整数 <literal>value</literal> を受け取り,
153
変換される値がより少ない桁数で表せる場合,
155
デフォルトの精度は1です.値0を精度0で変換した結果は,
157
前に付加する文字をゼロとしてフィールド幅を指定すると,
158
フィールド幅までの値では前にゼロを付加するパディングが
164
o : 整数 <literal>value</literal> を受け取り,
167
変換される値がより少ない桁数で表せる場合,
169
デフォルトの精度は1です.値0を精度0で変換した結果は,
171
前に付加する文字をゼロとしてフィールド幅を指定すると,
172
フィールド幅までの値では前にゼロを付加するパディングが
173
行われます. フィールド幅に8進数を使用することはできません.
178
x, X : 整数 <literal>value</literal> を受け取り,
179
符号なし16進数表記に変換します.<literal>x</literal>変換では,
180
文字``abcdef''が使用されます;<literal>X</literal>変換では,
182
精度はは表示される最小の桁数を指定します.
183
変換される値がより少ない桁数で表せる場合,
185
デフォルトの精度は1です.値0を精度0で変換した結果は,
187
前に付加する文字をゼロとしてフィールド幅を指定すると,
188
フィールド幅までの値では前にゼロを付加するパディングが
194
f : float または double の<literal>value</literal> を受け取り,
195
%[\-]<literal>ddd.ddd</literal>形式の10進数表記に変換します.
196
小数点以下の桁数は,精度指定子に等しくなります.
200
<para>精度が指定されない場合, 6桁が出力されます.</para>
203
<para>精度がゼロの場合, 小数点は表示されず,
204
システムは<literal>value</literal>に最も近い整数に丸めた数を
209
<para>小数点が出力される場合,最低でも1桁がその前に出力されます.</para>
215
e, E : 実数を受け取り,指数形式%[\-]<literal>d.ddde</literal>+/\-<literal>dd</literal>
217
小数点の前に1桁があり,小数点の後の桁数は精度指定子に等しくなります.
221
<para>精度が指定されない場合, 6桁が出力されます.</para>
224
<para>精度がゼロの場合, 小数点は表示されません.
229
<literal>E</literal> 変換文字の場合,
230
指数の前の e の代わりに E を付けた数値を出力します.
232
値が 0 の場合, 指数は 0 となります.
238
<para>g, G : 実数を受け取り,有効桁数を指定する精度を付けた
239
<literal>e</literal>, <literal>E</literal>, または
240
<literal>f</literal>変換文字の形式に変換します.
242
小数点は数字が続く場合にのみ表示されます.
243
使用される形式は変換される値に依存します.
246
変換結果の指数が-4よりも小さい場合,または,
248
<literal>e</literal> (使用されるフラグが<literal>G</literal>の場合は
249
<literal>E</literal>)形式が使用されます.
253
<para>c : 整数値を受け取り,文字に変換します.</para>
257
s : 文字列 <literal>value</literal> を受け取り,
258
文字列から末尾または精度に示された文字数に達するまで,
259
文字に変換します.精度が指定されない場合,末尾までの全ての文字が
267
桁文字の代わりに<literal>*</literal> (アスタリスク)で
269
この場合,整数 <literal>value</literal>パラメータは
271
出力に変換される<literal>value</literal> パラメータは
274
フィールド幅または精度を指定するパラメータは変換される値よりも
277
<para>変換の結果がフィールド幅よりも広い場合,
278
このフィールドは変換結果を含められる幅まで拡張されます.
281
+記号の意味は<literal>+</literal>または(空白)整形オプションの
284
<para>指数形式 %e の表示はプレットフォームに依存し,
287
<informaltable border="1">
290
<td>例: msprintf("%e",1.23e4)</td>
294
<td>1.23000e+004</td>
297
<td>Linux/Mac OS</td>
304
<programlisting role="example"><![CDATA[
15
<refname>printf_conversion</refname>
16
<refpurpose>mprintf, msprintf, mfprintf 変換仕様</refpurpose>
21
<literal>mprintf</literal> ,
22
<literal>msprintf</literal> , <literal>fprintf</literal>における各変換仕様.
23
<literal>format</literal> パラメータは以下のような構文を有します:
27
<para>A % (パーセント) 符号.</para>
31
0個以上の <literal>options</literal>で,
33
以下のリストに<literal>option</literal>文字とその意味を示します:
37
<para>- : 左揃え, フィールド内では, 変換の結果.</para>
40
<para>+ : (+または -)を指定する符号変換の結果を開始.</para>
44
符号変換後の最初の文字が符号ではない場合に結果の
46
(空白) および +オプションが共に指定された場合,
52
<literal>c</literal>, <literal>d</literal>, <literal>i</literal>,
53
<literal>s</literal>, および <literal>u</literal> 変換の場合,
54
<literal>#</literal>オプションの効果はありません.
55
<literal>o</literal> 変換の場合, <literal>#</literal> は
56
結果の最初の桁を強制的に0 (ゼロ)にし,精度を増加させます.
57
<literal>x</literal> および <literal>X</literal>変換の場合,
58
ゼロでない結果の前に0xまたは0Xが付加されます.
59
<literal>e, E, f, g,</literal> および <literal>G</literal>変換の場合,
60
小数点以下の値がない場合でも結果には常に小数点が含まれます.
61
<literal>g</literal> および
62
<literal>G</literal> 変換の場合,
69
<literal>i</literal>, <literal>o</literal>, <literal>u</literal>,
70
<literal>x</literal>, <literal>X</literal>, <literal>e</literal>,
71
<literal>E</literal>, <literal>f</literal>, <literal>g</literal>,
72
および <literal>G</literal>変換において
74
前に0をつけることによりフィールド幅内を埋めます:
76
<literal>0</literal> および <literal>\-</literal>(ダッシュ)が共に指定された場合,
77
<literal>0</literal>フラグは無視されます.
78
<literal>d</literal>, <literal>i</literal>,
79
<literal>o</literal> <literal>u</literal>, <literal>x</literal>,
80
および <literal>X</literal> 変換の場合, 精度が指定されると,
81
<literal>0</literal> フラグも無視されます.
90
変換された値の文字がこのフィールド幅よりも少ない場合,
91
フィールドはフィールド幅の指定長まで左側にパディングされます.
96
オプションの精度. 精度は <literal>.</literal> (ドット)の後に
99
このパラメータは 0 (ゼロ)と扱われます.
105
<literal>d</literal>,
106
<literal>u</literal>, <literal>o</literal>, <literal>x</literal>, または
107
<literal>X</literal>変換に関する最小表示桁数
112
<literal>e</literal>, <literal>E</literal>, および <literal>f</literal>
118
<literal>g</literal> および<literal>G</literal>変換における
124
<literal>s</literal>変換において文字列から出力される
129
<para>適用される変換の種類を示す文字:</para>
132
<para>% : 変換しません. %を表示.</para>
136
d,i: 整数 <literal>value</literal> を受け取り,
139
変換される値がより少ない桁数で表せる場合,
141
デフォルトの精度は1です.値0を精度0で変換した結果は,
143
前に付加する文字をゼロとしてフィールド幅を指定すると,
144
フィールド幅までの値では前にゼロを付加するパディングが
150
u : 整数 <literal>value</literal> を受け取り,
153
変換される値がより少ない桁数で表せる場合,
155
デフォルトの精度は1です.値0を精度0で変換した結果は,
157
前に付加する文字をゼロとしてフィールド幅を指定すると,
158
フィールド幅までの値では前にゼロを付加するパディングが
164
o : 整数 <literal>value</literal> を受け取り,
167
変換される値がより少ない桁数で表せる場合,
169
デフォルトの精度は1です.値0を精度0で変換した結果は,
171
前に付加する文字をゼロとしてフィールド幅を指定すると,
172
フィールド幅までの値では前にゼロを付加するパディングが
173
行われます. フィールド幅に8進数を使用することはできません.
178
x, X : 整数 <literal>value</literal> を受け取り,
179
符号なし16進数表記に変換します.<literal>x</literal>変換では,
180
文字``abcdef''が使用されます;<literal>X</literal>変換では,
182
精度はは表示される最小の桁数を指定します.
183
変換される値がより少ない桁数で表せる場合,
185
デフォルトの精度は1です.値0を精度0で変換した結果は,
187
前に付加する文字をゼロとしてフィールド幅を指定すると,
188
フィールド幅までの値では前にゼロを付加するパディングが
194
f : float または double の<literal>value</literal> を受け取り,
195
%[\-]<literal>ddd.ddd</literal>形式の10進数表記に変換します.
196
小数点以下の桁数は,精度指定子に等しくなります.
200
<para>精度が指定されない場合, 6桁が出力されます.</para>
203
<para>精度がゼロの場合, 小数点は表示されず,
204
システムは<literal>value</literal>に最も近い整数に丸めた数を
209
<para>小数点が出力される場合,最低でも1桁がその前に出力されます.</para>
215
e, E : 実数を受け取り,指数形式%[\-]<literal>d.ddde</literal>+/\-<literal>dd</literal>
217
小数点の前に1桁があり,小数点の後の桁数は精度指定子に等しくなります.
221
<para>精度が指定されない場合, 6桁が出力されます.</para>
224
<para>精度がゼロの場合, 小数点は表示されません.
229
<literal>E</literal> 変換文字の場合,
230
指数の前の e の代わりに E を付けた数値を出力します.
232
値が 0 の場合, 指数は 0 となります.
238
<para>g, G : 実数を受け取り,有効桁数を指定する精度を付けた
239
<literal>e</literal>, <literal>E</literal>, または
240
<literal>f</literal>変換文字の形式に変換します.
242
小数点は数字が続く場合にのみ表示されます.
243
使用される形式は変換される値に依存します.
246
変換結果の指数が-4よりも小さい場合,または,
248
<literal>e</literal> (使用されるフラグが<literal>G</literal>の場合は
249
<literal>E</literal>)形式が使用されます.
253
<para>c : 整数値を受け取り,文字に変換します.</para>
257
s : 文字列 <literal>value</literal> を受け取り,
258
文字列から末尾または精度に示された文字数に達するまで,
259
文字に変換します.精度が指定されない場合,末尾までの全ての文字が
267
桁文字の代わりに<literal>*</literal> (アスタリスク)で
269
この場合,整数 <literal>value</literal>パラメータは
271
出力に変換される<literal>value</literal> パラメータは
274
フィールド幅または精度を指定するパラメータは変換される値よりも
277
<para>変換の結果がフィールド幅よりも広い場合,
278
このフィールドは変換結果を含められる幅まで拡張されます.
281
+記号の意味は<literal>+</literal>または(空白)整形オプションの
284
<para>指数形式 %e の表示はプレットフォームに依存し,
287
<informaltable border="1">
290
<td>例: msprintf("%e",1.23e4)</td>
294
<td>1.23000e+004</td>
297
<td>Linux/Mac OS</td>
304
<programlisting role="example"><![CDATA[
305
305
mprintf('a string: %s\n', 'Scilab');
306
306
mprintf('an integer: %d\n', 10);
307
307
mprintf('an integer: %4d\n', 10);