OpenVMS マニュアル

fwscanf

ワイド文字の書式指定文字列の制御のもとで，ストリームから入力を読み込みます。

形式

#include <wchar.h>

int fwscanf (FILE *stream, const wchar_t *format, ...);

引数

stream

ファイル・ポインタ。

format

書式指定を格納したワイド文字の文字列を指すポインタ。書式指定と変換指定，および対応する引数の詳細については，『HP C ランタイム・ライブラリ・リファレンス・マニュアル(上巻)』第 2 章を参照してください。

...

省略可能な式であり，式の結果は書式指定に指定した変換指定に対応します。書式指定と変換指定，およびそれに対応する引数の詳細については，『HP C ランタイム・ライブラリ・リファレンス・マニュアル(上巻)』第 2 章を参照してください。

変換指定を指定しない場合は，入力ポインタを省略できます。変換指定を指定する場合は，関数呼び出しに変換指定と正確に同じ数の入力ポインタを指定する必要があります。変換指定は入力ポインタの型と一致しなければなりません。

変換指定は左から右への順に入力ソースに対応付けられます。入力ポインタの数の方が多い場合は，超過するポインタは無視されます。

説明

fwscanf関数は， format によって示されるワイド文字の文字列の制御のもとで， stream によって示されるストリームから入力を読み込みます。書式指定に対して引数が不足している場合は，動作は未定義になります。引数が残っているのに，書式指定が不足する場合は，超過する引数は評価されますが，無視されます。

書式指定は，次のような 0 個以上のディレクティブで構成されます。

• 1 つ以上の空白ワイド文字

• 通常のワイド文字 (パーセント記号 (%)) と空白ワイド文字を除く)

• 変換指定

各変換指定はワイド文字 % から始まります。

stream 引数によって示されるストリームがバイト単位でもワイド文字単位でもない場合は， fwscanfはストリームをワイド文字単位に設定します。

戻り値

n	代入した入力項目の数。提供された項目の数より少なくなることがあり，早い段階で照合エラーが発生した場合は，0 になることもあります。
EOF	エラーを示します。変換の前に入力エラーが発生しました。