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
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應