vsscanf

stdio.h：インデックス への移動

ヘッダーファイル

stdio.h

カテゴリ

メモリと文字列の操作ルーチン

プロトタイプ

int vsscanf(const char *buffer, const char *format, va_list arglist);

int vswscanf(const wchar_t *buffer, const wchar_t *format, va_list arglist);

説明

ストリームからの入力をスキャンして書式設定します。

v...scanf 系関数は，...scanf 系関数のかわりに使用できます。これらの関数の機能は，対応する ...scanf 系関数とまったく同じですが，引数リストではなく引数リストへのポインタを受け取る点が異なります。

メモ：  書式指定子の詳細は，「Scanf の書式指定子」を参照してください。

vsscanf は，ストリームから読み取った一連の入力フィールドを 1 文字ずつスキャンします。各フィールドは，format が指す書式文字列で vsscanf に渡された書式指定子にしたがって書式設定されます。最後に vsscanf は，format に続く引数として渡されたアドレスに，書式設定した入力を格納します。入力フィールドと同じ数の書式指定子とアドレスが必要です。

vsscanf は，通常のフィールド終了文字（ホワイトスペース）に到達する前に，特定のフィールドのスキャンを停止する場合があります。または，さまざまな原因で完全に処理を終了する場合もあります。考えられる理由については，scanf を参照してください。

戻り値

vsscanf は，スキャン，変換，および格納に成功した入力フィールドの数を返します。この戻り値には，スキャンされたが格納されなかったフィールドは含まれません。格納されたフィールドがない場合，戻り値は 0 になります。

vsscanf が文字列の末尾で読み取りを試みた場合，戻り値は EOF になります。

例

 #include <stdio.h>
 #include <stdarg.h>
 char buffer[80] = "30 90.0 abc";
 int vssf(char *fmt, ...)
 {
    va_list  argptr;
    int cnt;
    fflush(stdin);
    va_start(argptr, fmt);
    cnt = vsscanf(buffer, fmt, argptr);
    va_end(argptr);
    return(cnt);
 }
 int main(void)
 {
    int inumber;
    float fnumber;
    char string[80];
    vssf("%d %f %s", &inumber, &fnumber, string);
    printf("%d %f %s\n", inumber, fnumber, string);
    return 0;
 }

移植性

POSIX	Win32	ANSI C	ANSI C++
	+	+	+

関連項目

• C/C++ の書式指定子
• Scanf の書式文字列
• scanf の書式指定子
• Scanf, wscanf