各入力ポインタは，対応する変換指定と同じ型のオブジェクトを示すアドレス式です。変換指定は書式指定文字列の一部になります。示されるオブジェクトは，入力値を受け取るターゲットです。変換指定と同じ数だけ入力ポインタが必要であり，アドレスが指定されるオブジェクトは変換指定と同じ型でなければなりません。
表 2-3 書式設定された入力の変換指定子
| d
|
|
base
引数の値を 10 に設定した
strtol
関数のサブジェクト・シーケンスに対して期待される書式と同じ書式の 10 進整数が入力に期待される。対応する引数は
int
を指すポインタでなければならない。
|
| i
|
|
入力文字の先頭文字によって型が決定される整数が期待される。先頭が 0 の場合は 8 進数，先頭が 0X または 0x の場合は 16 進数，他のすべての形式の場合は 10 進数であると解釈される。対応する引数は
int
を指すポインタでなければならない。
|
| o
|
|
入力に 8 進整数 (先頭の 0 はあってもなくてもかまわない) が期待される。対応する引数は
int
を指すポインタでなければならない。
|
| u
|
|
base
引数の値が 10 の
strtoul
関数のサブジェクト・シーケンスに対して期待される書式と同じ書式の 10 進整数が入力に期待される。
|
| x
|
|
入力に 16 進整数 (先頭の 0x はあってもなくてもかまわない) が期待される。対応する引数は
unsigned int
を指すポインタでなければならない。
|
| c
|
バイト
|
入力に 1 バイトが期待される。対応する引数は
char
を指すポインタでなければならない。
c 変換指定子の前にフィールド幅が指定されている場合は，フィールド幅によって指定される文字数が読み込まれる。この場合，対応する引数は
char
型の配列を指すポインタでなければならない。
この変換指定子の前に省略可能な文字 l (小文字のエル) が指定されている場合は，ワイド文字コードに変換されるマルチバイト文字が入力に期待される。
対応する引数は
wchar_t
型を指すポインタでなければならない。 c 変換指定子の前にフィールド幅も指定されている場合は，フィールド幅によって指定された文字数が読み込まれる。この場合，対応する引数は
wchar_t
の配列を指すポインタでなければならない。
|
|
|
ワイド文字
|
省略可能なフィールド幅に指定された文字数が期待される。指定されていない場合は 1 になる。
c 指定子の前に l (小文字のエル) が指定されていない場合は，対応する引数は
char
の配列を指すポインタでなければならない。
c 指定子の前に l (小文字のエル) が指定されている場合は，対応する引数は
wchar_t
の配列を指すポインタでなければならない。
|
| C
|
バイト
|
ワイド文字コードに変換されるマルチバイト文字が入力に期待される。対応する引数は
wchar_t
型を指すポインタでなければならない。
C 変換指定子の前にフィールド幅も指定されている場合は，フィールド幅によって指定される文字数が読み込まれる。その場合，対応する引数は
wchar_t
の配列を指すポインタでなければならない。
|
|
|
ワイド文字
|
省略可能なフィールド幅に指定された文字数のシーケンスが期待される。指定されていない場合は 1 になる。対応する引数は
wchar_t
の配列を指すポインタでなければならない。
|
| s
|
バイト
|
入力にバイト・シーケンスが期待される。対応する引数は，バイト・シーケンスと，自動的に付加されるヌル区切り文字 (\0) を格納できるだけの十分な大きさの文字配列を指すポインタでなければならない。入力フィールドはスペース，タブ，改行文字で区切られる。
この変換指定子の前に省略可能な文字 l (小文字のエル) が指定されている場合は，ワイド文字コードに変換されるマルチバイト文字シーケンスが入力に期待される。対応する引数は，文字シーケンスの他に，自動的に付加される区切り文字のヌル・ワイド文字コードを格納できるだけの十分な大きさのワイド文字 (
wchar_t
型) の配列を指すポインタでなければならない。入力フィールドはスペース，タブ，改行文字で区切られる。
|
|
|
ワイド文字
|
入力に空白文字以外の文字シーケンスが期待される (概念上)。
s 指定子の前に l (小文字のエル) が指定されていない場合は，対応する引数は，シーケンスの他に，自動的に末尾に付加されるヌル・バイトを格納できるだけの十分な大きさの
char
の配列を指すポインタでなければならない。
s 指定子の前に l (小文字のエル) が指定されている場合は，対応する引数はシーケンスの他に，自動的に末尾に付加されるヌル・ワイド文字を格納できるだけの十分な大きさの
wchar_t
の配列を指すポインタでなければならない。
|
| S
|
バイト
|
ワイド文字コードに変換されるマルチバイト文字シーケンスが入力に期待される。対応する引数は，シーケンスの他に，自動的に末尾に付加されるヌル・ワイド文字コードを格納できるだけの十分な大きさのワイド文字 (
wchar_t
型) の配列を指すポインタでなければならない。
|
|
|
ワイド文字
|
空白文字以外の文字シーケンスが入力に期待される。対応する引数は，シーケンスの他に，自動的に末尾に付加されるヌル・ワイド文字を格納できるだけの十分な大きさの
wchar_t
の配列を指すポインタでなければらない。
|
| e，f，g
|
|
入力に浮動小数点数値が期待される。対応する引数は，
float
を指すポインタでなければならない。浮動小数点数値の入力形式は次のとおりである。 [±]nnn[radix][ddd][{E|e}[±]nn]. n と d は 10 進数である (フィールド幅によって示される桁数から符号と英字の E を差し引いた桁数)。基数を示す文字は現在のロケールで定義される。
|
| [...]
|
|
空白文字によって区切られていない空でない文字シーケンスが期待される。角括弧は，入力シーケンスに期待される文字セット (
scanset) を囲む。入力シーケンス内の文字のうち，scanset に含まれる文字に対応しない文字が検出されると，文字シーケンスは終了する。
角括弧で囲まれたすべての文字で scanset が構成される。ただし，左角括弧の直後の文字がサーカンフレックス (^) の場合は例外である。この場合は，scanset に含まれる文字は，サーカンフレックスと右角括弧で囲まれる文字以外のすべての文字になる。サーカンフレックスと右角括弧で
囲まれた文字が検出されると，入力文字シーケンスは終了する。
変換指定子が [] または [^] で始まる場合は，右角括弧文字は scanset に含まれ，次の右角括弧文字が指定を終了する右角括弧文字になる。それ以外の場合は，最初の右角括弧文字が検出されたときに，指定は終了する。
|
|
|
バイト
|
[ 指定子の前に l (小文字のエル) が指定されていない場合は， scanset に含まれる文字はシングル・バイト文字だけでなければならない。この場合，対応する引数は，シーケンスの他に，自動的に末尾に付加されるヌル・バイトを格納できるだけの十分な大きさの
char
の配列を指すポインタでなければならない。
[ 指定子の前に l (小文字のエル) が指定されている場合は，入力シーケンス内の文字はマルチバイト文字であると解釈され，その後の処理のためにワイド文字シーケンスに変換される。文字の範囲が scanset に指定されている場合は，処理は現在のプログラムのロケールの LC_COLLATE カテゴリに従って実行される。この場合，対応する引数は，シーケンスの他に，自動的に末尾に付加されるヌル・ワイド文字を格納できるだけの十分な大きさの
wchar_t
の配列を指すポインタでなければならない。
|
|
|
ワイド文字
|
[ 変換指定子の前に l (小文字のエル) が指定されていない場合は，処理は %l[ 指定子のバイト入力の場合と同じである。ただし，対応する引数は，マルチバイト・シーケンスの他に，自動的に末尾に付加されるヌル・バイトを格納できるだけの十分な大きさの
char
の配列を指すポインタでなければならない。
[ 変換指定子の前に l (小文字のエル) が指定されている場合は，処理は前に説明した場合と同じであるが，対応する引数は，ワイド文字シーケンスの他に，自動的に末尾に付加されるヌル・ワイド文字を格納できるだけの十分な大きさの
wchar_t
の配列を指すポインタでなければならない。
|
| p
|
|
void
を指すポインタが引数として期待される。入力値は 16 進数として解釈される。
|
| n
|
|
入力は使用されない。対応する引数は整数を指すポインタである。整数は，書式設定された入力関数に対するこの呼び出しで，これまで入力ストリームから読み込まれた文字数として代入される。 %n ディレクティブの実行は，書式設定された入力関数の実行が終了したときに返される代入カウントを増分しない。
|
| %
|
|
1 つのパーセント記号に対応する。変換や代入は実行されない。完全な変換指定は %% である。
|
