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 格式的寬度（例如 “%32s”，而不是 “%s”），否則，格式不正確的輸入可能會導致緩衝區滿溢。 或者，您可以使用 vscanf_s、 vwscanf_s 或 fgets。

vwscanf 是寬字元版本的 vscanf； format 的 vwscanf 引數是寬字元字串。 如果資料流在 ANSI 模式中開啟，則 vwscanf 和 vscanf 的行為相同。 vscanf 不支援來自 UNICODE 資料流的輸入。

一般文字常式對應

TCHAR.H 常式	_UNICODE 和 _MBCS 未定義	_MBCS 已定義	_UNICODE 已定義
_vtscanf	vscanf	vscanf	vwscanf

如需詳細資訊，請參閱 格式化規格欄位： scanf 和 wscanf 函式。

需求

常式	必要的標頭
vscanf	<stdio.h>
vwscanf	<stdio.h> 或 <wchar.h>

通用 Windows 平台 (UWP) 應用程式中不支援主控台。 與主控台 stdin、stdout 和 stderr 相關聯的標準資料流控制代碼必須重新導向，之後 C 執行階段函式才能在 UWP 應用程式中使用它們。 如需相容性詳細資訊，請參閱相容性。

範例

// 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

另請參閱

數學與浮點支援
資料流 I/O
地區設定
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