scanf(3S)

単独の % は、この場所での入力を求め、代入は行いません。

10 進数整数として解釈します。対応する引き数は、整数型へのポインターでなければなりません。

符号なしの 10 進数整数として解釈します。対応する引き数は、符号なしの整数型へのポインターでなければなりません。

８ 進数整数として解釈します。対応する引き数は、符号なしの整数型へのポインターでなければなりません。

16 進数整数として解釈します。対応する引き数は、符号なしの整数型へのポインターでなければなりません。 x および X の変換文字は、同じものです。

整数として解釈します。対応する引き数は、整数型へのポインターでなければなりません。 C 規約によって解釈された入力項目の次の値が代入されます。すなわち、先行する 0 は、８ 進数を示し、先行する 0x は、16 進数を示します。その他の場合は、10 進数が仮定されます。

extended 型として解釈します。 対応する引き数は、 extended 型のポインター (Itanium アーキテクチャでの 80 ビットの IEEE-754 double-extended 型) であり、浮動小数点指定子 a, A, e, E, f, g, G と一緒に使う必要があります。

関数が呼び出されてから今まで走査されたバイト総数 (空白を含む) を格納します。対応する引き数は、整数型へのポインターでなければなりません。 入力は使用しません。 関数の戻り値には、%n による一致および代入が成功した回数を含みません。

浮動小数点数として解釈します。次のフィールドは適切に変換され、対応する引き数 float へのポインター) に従って格納されます。 この変換コードで受け付けることのできる浮動小数点数の形式は次のとおりです。 つまり、数字列を基本とし、この数字列にオプションとして、符号、小数点キャラクタ、および指数フィールドが付いた形式です。 指数フィールドがある場合は、数字列の後ろに付きます。 指数自体は、 E または e を先頭に置いて、その後ろに +, -, またはスペースを置き、さらにその後ろに整数を置く、という形式を取ります。 ただし、 +, -, またはスペースは省略可能です。 Itanium(R) ベース システムの場合は、入力として 16 進浮動小数点数も受け付けます。 この場合の浮動小数点数の基本形式は次のとおりです。 つまり、16 進文字列を基本とし、この 16 進文字列に符号、小数点キャラクタ、および ２ 進指数フィールドが付いた形式です。 ２ 進指数フィールドがある場合は、16 進文字列の後ろに付きます。 ２ 進指数自体は、数の有効部分 (小数部) を実際の位にするためのスケーリングファクターを、２ を基数としたべき指数で表したものであり、 P または p を先頭に置いて、その後ろに +, -, またはスペース文字を置き、さらにその後ろに 10 進整数を置くという形式を取ります。 ただし、 +, -, またはスペースは省略可能です。 変換文字 A, E および G は、 a, e および g と、それぞれ同様の働きをします。 変換文字の a, A, e, E, f, g, および G は、文字列 inf (大文字と小文字の区別なし) または文字列 infinity (大文字と小文字の区別なし) を、 適切な浮動小数点の無限大値 (変換精度を示す識別子によって、単精度、倍精度、４ 倍精度といった精度が指定可能) に変換します。 変換文字の a, A, e, E, f, g, および G は、 文字列 nan (大文字と小文字の区別なし) を、 適切な浮動小数点の NaN 値 (変換精度を示す識別子によって、単精度、倍精度、４ 倍精度といった精度が指定可能) に変換します。

文字として解釈します。対応する引き数は文字型へのポインターでなければなりません。通常行われる空白のスキップは抑制されます。次の非スペース文字を読むには %1s を使います。フィールドの幅が与えられている場合には、対応する引き数は文字配列を参照します。すなわち、指定された個数の文字を読み取ります。

l (エル) 修飾子が存在する場合は、初期シフト状態で始まる文字シーケンスが入力されます。シーケンス内の各文字は、 mbrtowc() 関数を呼び出したかのようにワイドキャラクタに変換され、変換状態は、最初の文字が変換される前にゼロに初期化される mbstate_t オブジェクトによって記述されます。対応する引き数は、結果として生成されるワイドキャラクタのシーケンスを受け入れられる大きさの wchar_t の配列へのポインターでなければなりません。null ワイドキャラクタは付加されません。 通常行われる空白のスキップは抑制されます。次の非スペース文字を読むには、 %1S を使います。 フィールドの幅が与えられている場合には、対応する引き数はワイドキャラクタ配列を参照します。すなわち、指定された個数の文字を読み取り、変換します。

lc と同じです。

文字列として解釈します。対応する引き数は、文字列および自動的に付加される、終端の \0 を格納するのに充分な大きさを持った、文字の配列を指す文字型へのポインターでなければなりません。入力フィールドは、空白文字によって終了します。 scanf() は、null 文字列を読み取れません。

l (エル) 修飾子が存在する場合は、初期シフト状態で始まる文字シーケンスが入力されます。各文字は、 mbrtowc() 関数を呼び出したかのようにワイドキャラクタに変換され、変換状態は、最初の文字が変換される前にゼロに初期化される mbstate_t オブジェクトによって記述されます。対応する引き数は、このシーケンスと、自動的に付加される終端の null ワイドキャラクタを受け入れるのに充分な大きさを持った wchar_t の配列へのポインターでなければなりません。 入力フィールドは、空白文字によって終了します。 scanf() は、null 文字列を読み取れません。

ls と同じです。

文字列データを示し、通常行われる空白のスキップは抑制されます。左の角括弧の後に scanset と呼ばれる文字のセットを続け、右の角括弧で閉じます。入力フィールドは、scanset 中の文字で完全に構成される入力文字の最大限の連続です。アクセント記号 (^) が scanset の文字の最初にある場合には、相補的なオペレータとして作用して、scanset 文字列に含まれない残りの文字すべてを新たな scanset として再定義します。 scanset の作成は、ある規約に従って行われます。文字の範囲は first-last 形式で表され、[0123456789] は、[0-9] と書き表すことができます。 この規約を用いる際には、 first は last と辞書式の順番で等しいかまたは小さくなければなりません。そうでない場合には、ダッシュ自身を表すことになります。ダッシュは scanset 中の文字の最初あるいは最後にある場合にも、ダッシュ自身を表します。scanset の要素の中に右の角括弧を入れるには、scanset の最初の文字として現れる必要があり (できるならばアクセント記号を頭につけて)、そのような場合には、文法的に、閉じ括弧とは解釈されません。対応する引き数は、データフィールドおよび自動的に付加される終端の \0 を格納するのに充分な大きさを持った文字の配列を指す、文字型へのポインターでなければなりません。正常終了のためには、少なくとも １ 文字は一致する必要があります。

l (エル) 修飾子が存在する場合は、初期シフト状態で始まる文字シーケンスが入力されます。シーケンス内のそれぞれの文字は、 mbrtowc() 関数を呼び出したかのようにワイドキャラクタに変換され、変換状態は、最初の文字が変換される前にゼロに初期化される mbstate_t オブジェクトにより記述されます。対応する引き数は、このシーケンスと、自動的に付加される終端の null ワイドキャラクタを受け入れるのに充分な大きさの wchar_t の配列へのポインターでなければなりません。

符号なしの 16 進数として解釈します。この数字列は printf() によってできた、 p 変換文字である場合が多いと思われます。対応する引き数は、16 進数の数字列が格納される、 void 型へのポインターのポインターでなければなりません。この変換の動作は、現プログラムの実行中に、先に変換された値以外の入力項目に対しては定義されません。

O_NONBLOCK フラグが、 ストリーム のファイル記述子としてセットされており、プロセスが読み込み動作において遅延がかかっているような場合

ストリーム のファイル記述子が読み込みのためにオープンされるファイル記述子として不適切な場合

シグナルの受信により読み込み動作が中断され、データが転送されなかったり、ファイルに対する部分の転送が実行されなかった場合

プロセスがバックグランドプロセスの １ つになっている時に、制御ターミナルからの読み込みを行おうとしており、さらにプロセスが SIGTTIN シグナルを無視またはブロックしているか、あるいはプロセスのプロセスグループが親なしになっている場合

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