scanf、_scanf_l、wscanf、_wscanf_l

發行項
06/09/2015

從標準輸入資料流讀取格式化的資料。有更多這些函式的安全版本可用；請參閱 scanf_s、_scanf_s_l、wscanf_s、_wscanf_s_l。

int scanf(
   const char *format [,
   argument]... 
);
int _scanf_l(
   const char *format,
   locale_t locale [,
   argument]... 
);
int wscanf(
   const wchar_t *format [,
   argument]... 
);
int _wscanf_l(
   const wchar_t *format,
   locale_t locale [,
   argument]... 
);

參數

format
格式控制字串。
argument
選擇性引數。
locale
使用的地區設定。

傳回值

傳回成功轉換和指定的欄位數；傳回值不包括讀取但未指定的欄位。傳回值 0 表示未指定欄位。

如果 format 為 NULL 指標，則叫用無效參數處理常式，如參數驗證中所述。如果允許繼續執行，這些函式會傳回 EOF，並將 errno 設為 EINVAL。

如需有關這些錯誤碼和其他錯誤碼的詳細資訊，請參閱 _doserrno、errno、_sys_errlist 和 _sys_nerr。

備註

scanf 函式會從標準輸入資料流 stdin 讀取資料並將資料寫入 argument 引數所指定的位置。清單中的所有 argument 都必須是變數的指標，這些變數的類型對應至 format 的類型規範。如果在重疊的字串之間執行複製，則行為是未定義的。

安全性提示
當您使用 scanf 讀取字串時，通常要為 %s 格式指定寬度 (例如 "%32s" 而不是"%s")；否則，格式化不適當的輸入可能容易造成緩衝區滿溢。或著，請考慮使用 scanf_s、_scanf_s_l、wscanf_s、_wscanf_s_l 或 fgets。

wscanf 是 scanf 的寬字元版本。 wscanf 的 format 引數是寬字元字串。如果資料流是以 ANSI 模式開啟，則 wscanf 和 scanf 的行為相同。 scanf 目前不支援從 UNICODE 資料流輸入。

尾碼為 _l 的這些函式版本是一樣的，只不過它們使用傳入的地區設定，而不是目前執行緒的地區設定。

一般文字常式對應

TCHAR.H 常式	未定義 _UNICODE & _MBCS	已定義 _MBCS	已定義 _UNICODE
_tscanf	scanf	scanf	wscanf
_tscanf_l	_scanf_l	_scanf_l	_wscanf_l

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

需求

常式	必要的標頭
scanf, _scanf_l	<stdio.h>
wscanf, _wscanf_l	<stdio.h> 或 <wchar.h>

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

範例

// crt_scanf.c
// compile with: /W3
 /* This program uses the scanf and wscanf functions
  * to read formatted input.
  */

#include <stdio.h>

int main( void )
{
   int   i, result;
   float fp;
   char  c, s[81];
   wchar_t wc, ws[81];
   result = scanf( "%d %f %c %C %80s %80S", &i, &fp, &c, &wc, s, ws ); // C4996
   // Note: scanf and wscanf are deprecated; consider using scanf_s and wscanf_s
   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( L"%d %f %hc %lc %80S %80ls", &i, &fp, &c, &wc, s, ws ); // C4996
   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);
}