printf - 通信用語の基礎知識

元々はCで、書式付きの表示を行なうための関数。

概要

C言語の他、C言語の元々のプラットフォームであるUNIXのコマンドとして4.3BSD以降で採用され、またUNIXベースの各種言語(awk、Perlなど)でも採用されている。

互換性のためC++でも利用できるが、C++では書式変換のために他の方法も用意されている。

書式

printf(フォーマット文字列, 値1,値2, 値3...)

フォーマット文字列には、次のようなものがある。詳細は後述する。

関連

様々な関連する関数が定義されている。

#include <stdio.h>
- int printf(const char *format, ...);
- int fprintf(FILE *stream, const char *format, ...);
- int sprintf(char *str, const char *format, ...);
- int snprintf(char *str, size_t size, const char *format, ...);
#include <stdarg.h>
- int vprintf(const char *format, va_list ap);
- int vfprintf(FILE *stream, const char *format, va_list ap);
- int vsprintf(char *str, const char *format, va_list ap);
- int vsnprintf(char *str, size_t size, const char *format, va_list ap);

フォーマット文字列

変換指定

フォーマット文字列は、出力される書式の体裁を指示するための文字列である。そのまま表示される通常文字に加え、%から始まる変換指定が存在する。

変換指定は、%から始まり、変換指定子で終わる。その間には、0個以上のフラグ、最小フィールド幅、精度、長さ修飾子を、この順序にて置くことができる。

具体的な使用例は最後に記載する。

フラグ

#: 「別の形式」に変換する時に使う。その機能は、変換指定子によって変わってくる。; o変換では、先頭に0を追加する。; x、X変換では、値が0でない時には、先頭に0xまたは0Xを追加する。
0: 値を0で埋める。; d/i/o/u/x/X/a/A/e/E/f/F/g/G変換では、値の左側を、ゼロパディング(通常は空白パディング)する。
-: 変換値を、左揃えとする(通常は右揃え)。; -と0を同時に指定した場合は、-が優先される。
+: 常に符号(+または-)を置く。通常はマイナスの場合のみ-が置かれる。
空白: 値が正の値である場合、符号位置に空白を置く(通常は何も挿入されない)。負の値であれば同位置には-が置かれる。; +と空白を同時に指定した場合は、+が優先される。

この他にも、実装により独自の拡張が存在する。

最小フィールド幅

10進数で、最小のフィールド幅を指定する(頭文字は0以外)。

値が指定されたフィールド幅よりも小さい時は、フラグの指定により、空白やゼロでパディングされる。

値が指定されたフィールド幅よりも大きい時は、適切な幅に拡張される。

精度

数値の変換では、.(ピリオド)に続いて、10進数で精度桁数を指定できる。なお10進数は省略可能で、.(ピリオド)だけの場合は10進数は0が指定されたものとみなす。

整数変換(d/i/o/u/x/X)では、表示する最小桁数を指定する。

実数変換(a/A/e/E/f/F)では、小数点以下に表示する桁数を指定する。

g/Gの変換では、有効数字(整数桁含む)の最大桁数を指定する。

文字列の変換(s/S)では、出力する最大文字数を指定する。

長さ修飾子

整数変換(d/i/o/u/x/X)時、その引数の長さを指定する。

バージョンによって追加があるため、その旨も併記する。併記無きものは全バージョンで利用可能。

長さに関してはsigned/unsignedは問わない。どちらでも同じ修飾子を使う。

変換指定子

具体的な使用例

PRIから始まるのは、inttypes.hで#defineされてるマクロである。その環境に応じて適切なフォーマット文字列が定義されている。

リンク