vscanf, vwscanf
標準入力ストリームから書式付きデータを読み取ります。 これらの関数のセキュリティを強化したバージョンを使用できます。「vscanf_s、vwscanf_s」を参照してください。
構文
int vscanf(
const char *format,
va_list arglist
);
int vwscanf(
const wchar_t *format,
va_list arglist
);
パラメーター
format
書式指定文字列。
arglist
可変個引数リスト。
戻り値
正常に変換され、割り当てられたフィールドの数を返します。戻り値には、読み取られたが割り当てられないフィールドは含まれません。 戻り値が 0 の場合は、代入されたフィールドがなかったことを示します。
formatがNULL ポインターの場合、「パラメーターの検証で説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行の継続が許可された場合、これらの関数は EOF を返し、errno を EINVAL に設定します。
これらのエラー コードおよびその他のエラー コードの詳細については、「errno、_doserrno、_sys_errlist、_sys_nerr」を参照してください。
解説
vscanf 関数は、標準入力ストリーム stdin からデータを読み取り、そのデータを arglist 引数リストで指定されている位置に書き込みます。 リストの各引数は、format の型指定子に対応する型の変数へのポインターにする必要があります。 重なり合う文字列間でコピーした場合の動作は未定義です。
重要
vscanfを使用して文字列を読み取る場合は、常に%s形式の幅を指定します (たとえば、"%s" ではなく、"%32s")。それ以外の場合、誤って書式設定するとバッファー オーバーランが発生する可能性があります。 別の方法として、 vscanf_s、 vwscanf_s 、または fgetsを使用できます。
vwscanf 関数は、 vscanf関数のワイド文字バージョンです。 format 関数の引数 vwscanf は、ワイド文字列です。 ストリームが ANSI モードで開かれている場合、vwscanf と vscanf の動作は同じになります。 vscanf では、UNICODE ストリームからの入力はサポートされていません。
汎用テキスト ルーチンのマップ
| TCHAR.H のルーチン | _UNICODE と _MBCS が定義されていない |
_MBCS が定義されている |
_UNICODE が定義されている |
|---|---|---|---|
_vtscanf |
vscanf |
vscanf |
vwscanf |
詳細については、「 Format 仕様フィールド: scanf および wscanf 関数を参照してください。
要件
| ルーチンによって返される値 | 必須ヘッダー |
|---|---|
vscanf |
<stdio.h> |
vwscanf |
<stdio.h> または <wchar.h> |
ユニバーサル Windows プラットフォーム (UWP) アプリではコンソールがサポートされていません。 コンソール (stdin、stdout、stderr) に関連付けられている標準ストリームのハンドルは、C ランタイム関数によって UWP アプリで使用される前に、リダイレクトする必要があります。 互換性の詳細については、「 Compatibility」を参照してください。
例
// crt_vscanf.c
// compile with: /W3
// This program uses the vscanf and vwscanf functions
// to read formatted input.
#include <stdio.h>
#include <stdarg.h>
int call_vscanf(char *format, ...)
{
int result;
va_list arglist;
va_start(arglist, format);
result = vscanf(format, arglist);
va_end(arglist);
return result;
}
int call_vwscanf(wchar_t *format, ...)
{
int result;
va_list arglist;
va_start(arglist, format);
result = vwscanf(format, arglist);
va_end(arglist);
return result;
}
int main( void )
{
int i, result;
float fp;
char c, s[81];
wchar_t wc, ws[81];
result = call_vscanf( "%d %f %c %C %80s %80S", &i, &fp, &c, &wc, s, ws );
printf( "The number of fields input is %d\n", result );
printf( "The contents are: %d %f %c %C %s %S\n", i, fp, c, wc, s, ws);
result = call_vwscanf( L"%d %f %hc %lc %80S %80ls", &i, &fp, &c, &wc, s, ws );
wprintf( L"The number of fields input is %d\n", result );
wprintf( L"The contents are: %d %f %C %c %hs %s\n", i, fp, c, wc, s, ws);
}
71 98.6 h z Byte characters
36 92.3 y n Wide charactersThe number of fields input is 6
The contents are: 71 98.599998 h z Byte characters
The number of fields input is 6
The contents are: 36 92.300003 y n Wide characters
関連項目
数値演算と浮動小数点のサポート
ストリーム入出力
ロケール
fscanf、 _fscanf_l、 fwscanf、 _fwscanf_l
printf、 _printf_l、 wprintf、 _wprintf_l
sprintf、 _sprintf_l、 swprintf、 _swprintf_l、 __swprintf_l
sscanf、 _sscanf_l、 swscanf、 _swscanf_l
vscanf_s, vwscanf_s