printf | Programming Place Plus　Ｃ言語編　標準ライブラリのリファレンス

引数format の基本形式は、“%d” や “%s” といった変換指定の開始を意味する %記号と、変換指定子の組み合わせである。この指定の組み合わせ１つにつき、実引数… の個数を１つ増やす。ただし、後述する “%*d” のように、フィールド最小幅指定に * を用いた場合や、“%.*d” のように精度指定に * を用いた場合には、最小幅を指定するための実引数… を１つ追加しなければならない。

変換指定子には以下のものがある。

指定開始文字% の直後には、変換フラグを指定しても良い。変換フラグには以下のものがある。

変換フラグの指定の直後には、フィールド最小幅を指定しても良い。これは 10進整数で表現され、変換結果が最低でも何文字分の領域を使用するかを指定している。たとえば、“%7d” のように指定する。

この指定はあくまでも最小幅であって、これを超える文字数に変換された場合には、その文字数分だけ出力される。最小幅よりも変換結果の文字数の方が小さい場合には何らかの文字で埋められる。このとき使用される文字は、特に指定しなければ空白文字であるが、変換フラグの 0 を使用していれば、0 で埋められる。

フィールド最小幅の指定を * としても良く、この場合には、引数… の対応する値を調べ、そこに指定されていた整数を最小幅とみなす。たとえば、printf("%*d", length, num); のように指定した場合、変数num の値を “%d” で変換しようとし、その際の最小幅指定として、変数length の値が使用される。

フィールド最小幅の指定の直後には、精度を指定しても良い。これは、小数点と 10進整数で表現される。「精度」が意味するところは、変換指定子によって異なり、以下のとおりである。

精度の指定を * としても良く、この場合には、引数… の対応する値を調べ、そこに指定されていた整数を最小幅とみなす。たとえば、printf("%*d", recision, num); のように指定し、この場合、変数num の値を “%d” で変換しようとし、その際の精度として、変数precision の値が使用される。フィールド最小幅指定にも * を指定していた場合には、フィールド最小幅、精度、変換対象　の順番で実引数を消費する。

精度の指定の直後には、変換修飾子を指定しても良い。これには以下のものがある。これらの指定は、変換指定子が n の場合には、対応する実引数がどのような型へのポインタであるかを指示するという意味になる。

変換修飾子の直後には変換指定子が来る。これは省略できない。

必要な個数の実引数が指定されていない場合の動作は未定義だが、余分に指定されている場合には、評価は行われるが、printf関数としては無視する。

#include <stdio.h>

int main(void)
{
    short n;

#if 0
    // Visual Studio では %n変換を使う際には、これが必要
    // %n変換は危険性があるので、デフォルトでは無効になっている
    _set_printf_count_output(1);
#endif

    printf("simple string\n");
    printf("%d,  %s\n", 123, "abcde");
    printf("%08d,  %8s\n", 123, "abcde");
    printf("%-8d,  %8s\n", 123, "abcde");
    printf("%*d\n", 8, 123);
    printf("%3.2f\n", 12.34567f);
    printf("%*.*f\n", 3, 2, 12.34567f);
    printf("%s%hn\n", "abcde", &n);
    printf("%hd\n", n);
}

実行結果：

simple string
123,  abcde
00000123,     abcde
123     ,     abcde
     123
12.35
12.35
abcde
5

任意のストリームに対して同様の変換指定を行い出力するには、fprintf関数を使う。変換結果を文字の配列に格納するには sprintf関数を使う。
引数に … ではなく、va_list を使う vprintf関数がある。
ワイド文字版の wprintf関数がある。

第２章