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

入力された値が、可変個引数の部分に指定したメモリアドレスへ格納される。

入力が得られなかった場合や、表現できない文字が入力された場合は入力エラーが発生する。また、型が不適切であるような、不適切な入力が起こると照合エラーが発生する。

引数format の基本形式は、“%d” や “%s” といったように、指定の開始を意味する %記号と、変換指定子の組み合わせである。この指定の組み合わせ１つにつき、引数… の個数を１つ増やす。

変換指定子には以下のものがある。対応する実引数の型はデフォルトのものであり、後述する変換修飾子によって変化する。

指定開始文字% の直後に、* を置いた場合、変数への格納が抑制される。たとえば、“%*d %s” という指定に対して、「100 abc」という入力がなされた場合、%d 指定の効果によって、100 は読み取られるが、変数への格納は行われず、後続の %s変換へ進む。

任意で * を置いた直後には、最大フィールド幅の指定を置いても良い。これは 10進整数で指定し、変換結果が最大で何文字分の幅を取るかを意味する。たとえば、“%10s” という指定によって、文字列を 10文字分まで読み取る。

任意で最大フィールド幅の指定を置いた直後に以下の変換修飾子を指定してもよく、このさらに後続に続く変換指定子が、対応する実引数にどのように適用されるかを指示する。

wN の N は、先頭に 0 が付かない 10進整数を意味する（たとえば w32 のように指定）。<stdint.h> で定義されている最小幅の整数型（int_leastN_t や uint_leastN_t）、あるいは正確な幅の整数型（intN_t、uintN_t）のビット長と一致するものが選択される。該当するものがない場合の結果は処理系定義。

wfN の N は、先頭に 0 が付かない 10進整数を意味する（たとえば wf32 のように指定）。<stdint.h> で定義されている最速の整数型（int_fastN_t や uint_fastN_t）と一致するものが選択される。該当するものがない場合の結果は処理系定義。

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

引数format の中で、空白類文字（半角スペースやタブ文字^📘）は、複数の連続した空白類文字を無視することを表す。１文字の空白類文字を読み飛ばす目的で、“%d %d” のように、１文字の空白類文字を挟み込んでも、入力された文字列内で連続していれば、すべての空白類文字は読み飛ばされる。

#include <stdio.h>

int main(void)
{
    int num;
    char str[80];
    char numbers[80];
    char no_numbers[80];

    // 以下のいずれか１つを有効にして試すこと
    // 複数同時に試すと、入力の最後に現れる改行文字のために、正しく処理できない
    // １度に試すのなら、それぞれの scanf関数の直後で、
    //     scanf("%*[^\n]");
    // のようにして、実際に受け取った内容の直後から改行文字の直前までを読み飛ばし、
    // さらに、
    //     scanf("%*c");
    // として、改行文字を読み飛ばすといった工夫が必要である。

    scanf("%d", &num);
    scanf("%d %s", &num, str);            // str が溢れる危険性あり
    scanf("%d %79s", &num, str);          // str が溢れることはない
    scanf("%[0123456789]", numbers);      // やはり numbers は溢れる危険性がある
    scanf("%[^0123456789]", no_numbers);  // やはり no_numbers は溢れる危険性がある
    scanf("%79[0123456789]", numbers);    // numbers が溢れることはない
}

実行結果：

任意のストリームに対して同様の変換指定を行い出力するには、fscanf関数を使う。対象が文字列の場合は sscanf関数が使える。

引数に … ではなく、va_list を用いたバージョンとして、vscanf関数がある。