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

概要

標準入力から、変換指定を伴ったワイド文字列を受け取る。

ヘッダ

wchar.h

形式

int vwscanf(const wchar_t* restrict format, va_list args);

引数

format

変換指定を伴った文字列。

args

format に含まれている変換指定子に対応した、可変個引数リスト。

戻り値

変換を１つも行えないまま入力エラーが起きた場合は、EOF を返す。その他の場合には、正常に代入を行えた個数を返す。

詳細

引数… が va_list に変わっていること以外は、wscanf関数と同様であり、同じ機能を持つ。
変換指定の詳細については、scanf関数を参照。

注意

第２引数に渡す va_list型のオブジェクトは、事前に va_start による初期化が必要である。

必要な個数の実引数が指定されていない場合の動作は未定義。余分に指定されている場合には、評価は行われるが、vwscanf関数としては無視する。

使用例

#include <stdio.h>
#include <wchar.h>
#include <stdarg.h>
#include <assert.h>

static void checked_input(int count, const wchar_t* format, ...)
{
    va_list args;

    va_start(args, format);
    if (vwscanf(format, args) != count) {
        assert("vwscanf error");
    }
    va_end(args);
}

int main(void)
{
    int num;
    double f;

    checked_input(2, L"%d %lf", &num, &f);
    printf("%d %lf\n", num, f);
}

実行結果

10 5.5
10 5.500000

関連

任意のストリームに対して同様の変換指定を行い入力を受け取るには、vfwscanf関数を使う。対象がワイド文字の配列の場合は、vswscanf関数が使える。
va_list の代わりに、… を用いたバージョンとして、wscanf関数がある。
また、マルチバイト文字に対応した vscanf関数がある。

解説章

第５２章