printf(3S)

変換指定子の意味を修飾する ０ 個以上の flags。

最小の field width (フィールドの幅) をバイト単位で指定するオプションの文字列の 10 進数数字。 変換した値の文字数が指定した field width に満たない場合、 field width の左に空白が埋め込まれて (後で説明する左揃えフラグ (-) が指定されているときは右に空白が埋め込まれて) 表示されます。 field width を指定する数が ０ で始まっていると、左側に ０ が埋め込まれて右揃えになります (下記のゼロ先行フラグ 0 を参照してください)。

変換のタイプが d, i, o, u, x, X のいずれかのときは最小桁数、 a, e または f のときは小数点キャラクタ以下の桁数、 g のときは有効桁の最大値、 s のときは文字列からプリントするバイトの最大値を指定する precision (精度)。 precision は、ピリオド の後に 10 進数数字文字列を記述して表します。null 数字文字列はゼロとして扱われます。

英文字の l。 これはオプションで、変換タイプが d, i, o, u, x, X のいずれかの場合は、 arg が long 整数であることを示します。 このとき変換タイプが n の場合は、 arg が long 整数へのポインターであることを示します。 または h、 これもオプションで、変換タイプが d, i, o, u, x, X のいずれかの場合は、 arg が short 整数であることを示します。 変換タイプが n の場合は、 arg が short 整数へのポインターであることを示します。 または hL、 これもオプションで、変換タイプが a, e, f, g のいずれかの場合は、 arg が extended 型 (Itanium アーキテクチャでの 80 ビットの IEEE-754 double-extended 型) であることを示します。 または ll、 これもオプションで、変換タイプが d, i, o, u, x, X のいずれかの場合は、 arg が long long 整数であることを示します。 あるいは L、 これもオプションで、変換タイプが a, A, e, E, f, g, G のいずれかの場合、 arg が長倍精度浮動小数点数であることを示します。 l, h, ll L が他の変換指定文字の前に現れた場合は無視されます。

変換のタイプを表す文字。

10 進数変換 (%i, %d, %u, %f,%g, または %G) の結果の整数部分は、３ 桁ごとにグルーピング文字でフォーマットされた書式にする。 何千ものグルーピングと区切り文字がある場合は、それぞれ LC_NUMERIC カテゴリの "grouping" フィールドと "thousands_sep" フィールドによって決定されます (localedef(4) を参照)。 他の変換に対して、動作は定義されていません。 通貨以外のグルーピング文字が使用されます。

変換した結果の値をフィールド内で左詰めにする。

符号付きの変換の結果の値に必ず符号 (+ または -) を付ける。

符号付きの変換結果の値の最初の文字が符号ではない場合、１ 文字の空白を付加する。 したがって、ブランクフラグと + フラグの両方が指定された場合は、ブランクフラグは無視されます。

このフラグは値を「代替形式」に変換します。 変換タイプが c, d, i, s, n, u のいずれかのときはこのフラグは意味がなく、 o のときは結果の精度を高くして １ 桁目が必ず ０ になるようにし、 x または X のときは ０ 以外の結果に 0x または 0X が付加され、 p のときは ０ 以外の結果に 0x が付加され、 a, A, e, E, f, g, G のいずれかのときは、結果の値は、小数部に値がなくても必ず小数点キャラクタを含むことになります (通常は小数部に数字がある場合にのみ小数点キャラクタが出力されます)。 変換タイプが g または G の時、小数部内の後方の ０ はそのまま出力されます (通常は除去されます)。

(符号または基底表示の前に) ０ を付加すると、すべての変換タイプについて field width を ０ で埋めます。 空白の埋め込みは行われません。 0 と - の両方が指定された場合は、 0 フラグは無視されます。 変換タイプが d, i, o, u, p, x, X, のいずれかの場合は、精度が指定されていれば、 0 フラグは無視されます。

整数値である arg を (d または i の時) 符号付きの 10 進数に、 (o の時) 符号なし ８ 進数に、 (u の時)10 進数に、 (x または X の時)16 進数に、それぞれ変換します。 変換タイプ x では英文字 abcdef が、 X では英文字 ABCDEF が使われます。 precision で表示される桁数の最小値を指定します。変換された値をそれより少ない桁数で表示できる場合、値の先頭に ０ が付加されます。 (旧バージョンとの互換性を考慮して、この ０ を詰める指定は field width を指定する値の前に ０ を付加することでも行えます。 これは field width の値が ８ 進数であることは意味しません)。 precision のデフォルト値は １ です。 precision が ０ の場合に ０ という値を変換した結果は null 文字列になります。

倍精度数の arg を [-]dddrddd という形式の 10 進数に変換します。 ここで r は小数点キャラクタです。 小数点キャラクタの後ろの桁数は、 precision として指定した値と等しくなります。 precision が省略された場合は小数部の長さは ６ 桁になります。 precision に ０ を指定したときは、小数点キャラクタは表示されません。

倍精度数の arg を、 [-]drddde±ddd という形式に変換します。ここで、 r は小数点キャラクタです。 小数点キャラクタの前は １ 桁、後ろの桁数は precision として指定した値と等しくなります。 precision を省略した場合は、小数部の長さは ６ 桁になります。 precision に ０ を指定した場合は小数点キャラクタは表示されません。 E フォーマットコードは指数部の前の文字を e の代わりに E にします。 指数部の最小の長さは ２ 桁です。

倍精度数の arg を、 f または e (G フォーマットコードの場合は E) 形式でプリントします。 precision に指定した値が有効桁数になります。 形式は変換された値によって決まります。つまり、指数部の値が -4 より小さいか、または precision の値以上のときは e が選ばれます。 小数部内の後方のゼロは除去されます。また小数点キャラクタはそれより下に数字があるときだけ表示されます。

Itanium(R) ベース システム専用。 倍精度の arg を、 [-]0xhrhhhp±d という形式に変換します。 ここで r は小数点キャラクタです。 小数点キャラクタの前は １ 桁、後ろの桁数は precision として指定した値と等しくなります。 precision を省略した場合、 double では 13 桁、 extended では 15 桁、 long double では 28 桁になります (値を正確に表現するには、この桁数で十分です)。 precision に ０ を指定した場合は、小数点キャラクタは表示されません。 a を指定した場合の変換では、英字 abcdef が使われ、 A を指定した場合の変換では、英字 ABCDEF が使われます。 A 変換指定子では、 x と p の代わりに X と P を使って数が表示されます。 指数部は少なくとも １ 桁表示され、それ以上必要なときは、指数 (２ を基数としたべき乗数) を 10 進数で表現するのに必要なだけの桁数で表示されます。 値が ０ の場合は、指数は ０ になります。

整数値の arg を符号なし文字に変換し、結果の文字をプリントします。 l (エル) 修飾子が存在する場合には、 wchar_t arg は、 LC_CTYPE の設定に従って １ つのワイドキャラクタを表すバイトの配列に変換されます。 結果のバイトがプリントされます。 field width が小さくてワイドキャラクタが分けられるようであれば、ワイドキャラクタをプリントして、 field width はそれに合うように大きくされます。

_INCLUDE__STDC_A1_SOURCE のみ

l (エル) 修飾子が存在する場合、引き数 wint_t は ls 変換指定を使ったかのように、精度を指定せず、２ つの要素からなる型 wchar_t を指し示す引き数を指定して変換されます。この ２ つの要素とは、 ls 変換指定に対する wint_t 引き数を含む要素と、null ワイドキャラクタを含む要素です。

lc と同じです。

arg は文字列 (文字ポインター) であるものとし、文字列内から null 文字 (\0) を検出するまで、もしくは precision で指定した数の文字をプリントします。 precision が省略されると無限とみなされ、最初の null 文字までの文字がプリントされます。 arg が NULL のとき結果は保証されません。

l (ell) 修飾子が存在する場合、引き数は型 wchar_t の配列へのポインターでなければなりません。 この配列のワイドキャラクタは、終端 null ワイドキャラクタまで (これを含む) 変換されます (各文字は wcrtomb() 関数を呼び出したかのように変換され、変換状態は、最初のワイドキャラクタが変換される前にゼロに初期化された mbstate_t オブジェクトによって記述されます)。結果として生成される文字は終端 null キャラクタ (バイト) の直前まで書き込まれます。

精度が指定されない場合は、配列に null ワイドキャラクタを １ つ含める必要があります。精度が指定される場合は、これ以上の文字 (バイト) は書き込まれず (シフトシーケンスがある場合には、それも含む)、精度によって設定された文字シーケンス長と等価にするために、関数が配列直後のワイドキャラクタにアクセスする必要がある場合には、配列に null ワイドキャラクタを １ つ含めなければなりません。どちらの場合にも、部分文字の書き込みは行われません。

ls と同じです。

void 型のへのポインター arg の値が連続する符号なし 16 進数としてプリントされます。 precision は表示される最小の桁数を指定します。変換した値をそれよりも少ない桁数で表示できる場合は、値の先頭にゼロが付加されます。 precision のデフォルト値は １ です。 precision が ０ のときに ０ という値を変換すると、結果は null 文字列となります。

arg は整数へのポインターとみなされます。 このポインターは、この関数の呼び出しで、それまでに出力ストリームにプリントされたバイト数を書き込むために使われます。 引き数の変換は行われません。

% をプリントし、引き数の変換は行いません。 変換指定全体が %% でなければなりません。

O_NONBLOCK フラグが stream であるファイル記述子に設定されていて、書き出し処理の際にプロセスが遅延させられている場合

stream であるファイル記述子が正しい書き出し用のファイル記述子でない場合

プロセスのファイルサイズ上限またはファイルサイズの最大値を越えてファイルに書き出そうとした場合 ulimit(2) を参照してください)

write() システムコールの間にシグナルを受け取った場合

プロセスがバックグラウンド プロセスグループにあって制御ターミナルに書き出そうとしたとき、 TOSTOP が設定されていて、プロセスが SIGTTOU シグナルを無視またはブロックせずに、プロセスのプロセスグループが親なしの場合

ファイルの存在するデバイスに空きスペースが残っていない場合

読み出しのためにプロセスでオープンされていない パイプ または FIFO に書き出そうとしたとき。 SIGPIPE シグナルがプロセスに送られた場合

入力ストリームから取得したデータは、有効なワイドキャラクタを構成しません。

使用可能な記憶領域が不足しています。