_cscanf_s、_cscanf_s_l、_cwscanf_s、_cwscanf_s_l

發行項
06/09/2015

從主控台讀取格式化資料。這些更安全的 _cscanf、_cscanf_l、_cwscanf、_cwscanf_l 版本有安全性增強功能，如 CRT 中的安全性功能中所述。

重要

這個應用程式開發介面不能用於 Windows 執行階段執行的應用程式。如需詳細資訊，請參閱 /ZW 不支援 CRT 函式。

int _cscanf_s( 
   const char *format [,
   argument] ... 
);
int _cscanf_s_l( 
   const char *format,
   locale_t locale [,
   argument] ... 
);
int _cwscanf_s( 
   const wchar_t *format [,
   argument] ... 
);
int _cwscanf_s_l( 
   const wchar_t *format,
   locale_t locale [,
   argument] ... 
);

參數

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

傳回值

已成功轉換和指定欄位的數目。回傳值不包含位指定的欄位。傳回值是嘗試的 EOF 可以讀取檔案的結尾。當輸入重新導向在作業系統命令列層級時，就會發生。傳回值 0 表示沒有意義的欄位。

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

備註

_cscanf_s 函式會將資料直接從主控台輸入 argument指定的位置。 _getche 函式用來讀取字元。所有可選參數都必須是變數的指標，這些變數的類型對應至 format 的類型規範。格式控制輸入字段的解釋和具有相同的形式和功能的format 參數為 scanf_s 的函式。當 _cscanf_s 通常回應輸入字元時，如果最後一次呼叫是 _ungetch 則它不這樣做。

就像在scanf _cscanf_s 和 _cswscanf_s 家族中的其他安全版本函式中，對型別欄位字元 c、 C、 s、 S和 [ 要求參數大小。如需詳細資訊，請參閱scanf 寬度規格。

注意事項
大小參數的類型是 unsigned，不是 size_t。

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

一般文字常式對應

TCHAR.H 常式	未定義 _UNICODE and _MBCS	已定義 _MBCS	已定義 _UNICODE
_tcscanf_s	_cscanf_s	_cscanf_s	_cwscanf_s
_tcscanf_s_l	_cscanf_s_l	_cscanf_s_l	_cwscanf_s_l

需求

常式	必要的標頭
_cscanf_s,_cscanf_s_l	<conio.h>
_cwscanf_s, _cwscanf_s_l	<conio.h> 或 <wchar.h>

如需相容性的詳細資訊，請參閱相容性。

程式庫

C 執行階段程式庫的所有版本。

範例

// crt_cscanf_s.c
// compile with: /c
/* This program prompts for a string
 * and uses _cscanf_s to read in the response.
 * Then _cscanf_s returns the number of items
 * matched, and the program displays that number.
 */

#include <stdio.h>
#include <conio.h>

int main( void )
{
   int result, n[3];
   int i;

   result = _cscanf_s( "%i %i %i", &n[0], &n[1], &n[2] );
   _cprintf_s( "\r\nYou entered " );
   for( i=0; i<result; i++ )
      _cprintf_s( "%i ", n[i] );
   _cprintf_s( "\r\n" );
}