書式付き入力を行います。

［所属］

標準ライブラリ

［指定形式］

#include <stdio.h>

int sscanf(const char *s, const char *format[, arg, ...]);

［戻り値］

走査，変換，格納が正常に実行できた入力フィールドの個数を返します。返却値には，格納されなかった走査済みフィールドは含まれません。ファイルの終わりで読み込もうとした場合，返却値はEOFです。フィールドが格納されなかった場合は，返却値は0です。

［詳細説明］

formatの指す文字列で指定された書式に従い，その後ろに続く引数argを，変換された入力を格納するオブジェクトを指すポインタとして扱い，sの指す配列から変換する入力を読み込みます。

formatには，認識されうる入力列，および“代入のためにどのように変換を行うか”ということを指定します。formatに対し十分な引数が存在しない場合，その動作は不定となります。引数が残っているのにformatが使い果たされた場合，残された引数は無視されます。

formatは，次に示す3種類のディレクティブにより構成されます。

各変換指示は“%”で始まります。“%”の後ろは，次のようになります。

%[代入抑制文字][フィールド長][サイズ][型指定文字]

それぞれの変換指示について，次に説明します。

入力フィールドの解釈，および代入を抑制する“*”です。

最大フィールド長を規定する0以外の10進整数です。入力フィールドを変換する前に読み込まれる最大文字数を指定します。入力フィールドがこのフィールド長より小さい場合，本関数はフィールド内のすべての文字を読み込み，次のフィールドとその変換指示へ進みます。また，フィールド長分を読み込む前に，空白文字，または変換できない文字が見つかった場合，その文字までの文字群を読み込み，変換し，格納します。その後，本関数は次の変換指示へ進みます。

対応する引数のデータ型を解釈するデフォルトの方法を変更する，任意選択のサイズ文字h，l，ll，およびLです。

hを指定した場合，後ろに続くd，i，n，o，u，xの型指定を強制的にshort int型に変換し，short型で格納します。c，e，f，n，p，s，D，I，O，U，Xでは，何もしません。

lを指定した場合，後ろに続くd，i，n，o，u，xの型指定を強制的にlong int型に変換し，long型で格納します。e，f，gでは，強制的にdouble型に変換し，double型で格納します。c，n，p，s，D，I，O，U，Xでは，何もしません。

llを指定した場合，後ろに続くd，i，o，u，x，Xの型指定を強制的にlong long型に変換し，long long型で格納します。他の型指定では，何もしません。

Lを指定した場合，後ろに続くe，f，gの型指定を強制的にlong double型に変換し，long double型で格納します。他の型指定では，何もしません。

これら以外の場合，その動作は不定です。

適用される変換の型を指定する文字です。変換の型を指定する文字とその意味を次に示します。

浮動小数点数（型指定文字e，f，g，E，F，G）の場合，次の一般形式に対応させてください。

[ + | - ] ddddd [ . ] ddd [ E | e [ + | - ] ddd ]

ただし，上記の一般形式のうち[ ]で囲まれた部分は任意選択であり，dddは10進数字を表します。

［注意事項］

以上の理由からその時点の入力フィールドの走査を停止すると，次の文字が未読であるとみなされ，次の入力フィールドの最初の文字，またはその入力のあとの読み込み操作の最初の文字として使用されます。

［使用例］

#include    <stdio.h>

void func(void) {

    int         i, n;

    float       x;

    const char  *s;

    char        name[10];

    s = "23 11.1e-1 NAME";

    n = sscanf(s,"%d%f%s", &i, &x, name);   /*iに23，xに1.110000，nameに“NAME”を格納，*/

                                            /*戻り値nは3*/

}