scanf_s
、 、 _scanf_s_l
、 wscanf_s
_wscanf_s_l
從標準輸入資料流讀取格式化資料。 這些版本的scanf
、 _scanf_l
、 wscanf
_wscanf_l
具有安全性增強功能,如 CRT 中的安全性功能中所述。
語法
int scanf_s(
const char *format [,
argument]...
);
int _scanf_s_l(
const char *format,
_locale_t locale [,
argument]...
);
int wscanf_s(
const wchar_t *format [,
argument]...
);
int _wscanf_s_l(
const wchar_t *format,
_locale_t locale [,
argument]...
);
參數
format
格式控制字串。
argument
選擇性引數。
locale
要使用的地區設定。
傳回值
傳回已成功轉換並指派的欄位數目。 傳回值不包含已讀取但未指派的欄位。 傳回值為 0 表示未指派任何欄位。 傳回值 EOF
適用於錯誤,或如果在第一次嘗試讀取字元時找到檔尾字元或字串結尾字元。 如果 format
為NULL
指標,則會叫用無效的參數處理程式,如參數驗證中所述。 如果允許繼續執行,則 scanf_s
和 wscanf_s
會傳回 EOF
,且 errno
設為 EINVAL
。
如需這些錯誤碼和其他錯誤碼的相關信息,請參閱errno
、 _doserrno
_sys_errlist
和 _sys_nerr
。
備註
函 scanf_s
式會從標準輸入資料串流讀取資料, stdin
並將它 argument
寫入 。 每個 argument
都必須是對應至 中 format
型別規範之變數類型的指標。 如果在重疊的字串之間進行複製,則行為是未定義的。
wscanf_s
是寬字元版本的 scanf_s
; format
的 wscanf_s
引數是寬字元字串。 如果資料流在 ANSI 模式中開啟,則 wscanf_s
和 scanf_s
的行為相同。 scanf_s
目前不支援來自 UNICODE 資料流的輸入。
具有 _l
後綴的這些函式版本完全相同,不同之處在於它們會使用 locale
參數,而不是目前的線程地區設定。
與和 wscanf
不同scanf
,scanf_s
而且wscanf_s
要求您指定某些參數的緩衝區大小。 指定所有c
、C
、、 S
s
或 字串控制集[]
參數的大小。 字元中的緩衝區大小會以另一個參數的形式傳遞。 它會緊接在緩衝區或變數的指標後面。 例如,如果您要讀取字串,則會傳遞該字串的緩衝區大小,如下所示:
char s[10];
scanf_s("%9s", s, (unsigned)_countof(s)); // buffer size is 10, width specification is 9
緩衝區大小包含終端機 Null。 您可以使用寬度規格欄位來確保讀取中的權杖符合緩衝區。 當令牌太大而無法容納時,除非有寬度規格,否則不會寫入緩衝區。
注意
大小參數為型別 unsigned
,而非 size_t
。 使用靜態轉型,以針對 64 位元組建組態,將 size_t
值轉換成 unsigned
。
緩衝區大小參數描述字元數目上限,而非位元元組數。 在此範例中,緩衝區類型的寬度不符合格式規範的寬度。
wchar_t ws[10];
wscanf_s(L"%9S", ws, (unsigned)_countof(ws));
S
格式規範表示使用函式所支援的預設寬度「相反」的字元寬度。 字元寬度是單一位元組,但函式支援雙位元組位元。 這個範例會以最多9個單位元組寬字元的字串讀取,並將它們放在雙位元組寬字元緩衝區中。 字元會視為單一位元組值;前兩個字元會儲存在 ws[0]
中,而後兩個會儲存在 ws[1]
中,依此類推。
這個範例會讀取單一字元:
char c;
scanf_s("%c", &c, 1);
讀取非 Null 終止字串的多個字元時,整數會同時用於寬度規格和緩衝區大小。
char c[4];
scanf_s("%4c", c, (unsigned)_countof(c)); // not null terminated
如需詳細資訊,請參閱 scanf
寬度規格。
一般文字常式對應
TCHAR.H 常式 |
_UNICODE 和 _MBCS 未定義 |
_MBCS 已定義 |
_UNICODE 已定義 |
---|---|---|---|
_tscanf_s |
scanf_s |
scanf_s |
wscanf_s |
_tscanf_s_l |
_scanf_s_l |
_scanf_s_l |
_wscanf_s_l |
如需詳細資訊,請參閱 格式化規格欄位: scanf
和 wscanf
函式。
需求
常式 | 必要的標頭 |
---|---|
scanf_s , _scanf_s_l |
<stdio.h> |
wscanf_s , _wscanf_s_l |
<stdio.h> 或 <wchar.h> |
通用 Windows 平台 (UWP) 應用程式中不支援主控台。 標準數據流句柄 stdin
、 stdout
和 stderr
必須先重新導向,C 執行時間函式才能在 UWP app 中使用它們。 如需相容性詳細資訊,請參閱相容性。
範例
// crt_scanf_s.c
// This program uses the scanf_s and wscanf_s functions
// to read formatted input.
#include <stdio.h>
#include <stdlib.h>
int main( void )
{
int i,
result;
float fp;
char c,
s[80];
wchar_t wc,
ws[80];
result = scanf_s( "%d %f %c %C %s %S", &i, &fp, &c, 1,
&wc, 1, s, (unsigned)_countof(s), ws, (unsigned)_countof(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 = wscanf_s( L"%d %f %hc %lc %S %ls", &i, &fp, &c, 2,
&wc, 1, s, (unsigned)_countof(s), ws, (unsigned)_countof(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 characters
The 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