fscanf_s、_fscanf_s_l、fwscanf_s、_fwscanf_s_l

發行項
06/09/2015

從資料流讀取格式化的資料。這些 fscanf、_fscanf_l、fwscanf、_fwscanf_l 版本有安全性增強功能，如 CRT 中的安全性功能中所述。

int fscanf_s( 
   FILE *stream,
   const char *format [,
   argument ]... 
);
int _fscanf_s_l( 
   FILE *stream,
   const char *format,
   locale_t locale [,
   argument ]... 
);
int fwscanf_s( 
   FILE *stream,
   const wchar_t *format [,
   argument ]... 
);
int _fwscanf_s_l( 
   FILE *stream,
   const wchar_t *format,
   locale_t locale [,
   argument ]... 
);

參數

stream
指向 FILE 結構的指標。
format
格式控制字串。
argument
選擇性引數。
locale
使用的地區設定。

傳回值

每個這些函式都會傳回成功轉換和指派的欄位數；傳回值不包括已讀取但未指派的欄位。傳回值 0 表示未指定欄位。如果發生錯誤，或者在第一個轉換前就已經到達檔案檔案資料流結尾，則傳回值會是 fscanf_s 和 fwscanf_s 的 EOF。

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

備註

fscanf_s 函式會將 stream 目前位置的資料讀取到 argument 引數清單 (如果有) 所指定的位置。清單中的所有 argument 都必須是變數的指標，這些變數的類型對應至 format 的類型規範。 format 控制輸入欄位的說明並有與scanf_s format引數相同的表單和函式；提供 format的說明請參閱格式規格欄位：scanf 和 wscanf 函式。 fwscanf_s 是 fscanf_s的寬字元版本;對 fwscanf_s 的格式引數是寬字元字串。如果資料流是以 ANSI 模式開啟，則這些函式的行為相同。 fscanf_s 目前不支援從 UNICODE 資料流輸入。

更安全的函式 (具有 _s 後置字元) 和其他版本之間的主要差異在於，更安全的函式需要每個 c、C、s、S 和 [ 類型欄位的大小 (以字元為單位)，當做變數之後的引數傳遞。如需詳細資訊，請參閱scanf_s、_scanf_s_l、wscanf_s、_wscanf_s_l與scanf 寬度規格。

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

這些有 _l 尾碼的函式版本是一樣的，不同之處在於它們會使用傳入的地區設定，而不使用目前的執行緒地區設定。

一般文字常式對應

TCHAR.H 常式	未定義 _UNICODE & _MBCS	已定義 _MBCS	已定義 _UNICODE
_ftscanf_s	fscanf_s	fscanf_s	fwscanf_s
_ftscanf_s_l	_fscanf_s_l	_fscanf_s_l	_fwscanf_s_l

需求

Function	必要的標頭
fscanf_s, _fscanf_s_l	<stdio.h>
fwscanf_s, _fwscanf_s_l	<stdio.h> 或 <wchar.h>

如需其他相容性資訊，請參閱相容性。

範例

// crt_fscanf_s.c
// This program writes formatted
// data to a file. It then uses fscanf to
// read the various data back from the file.
 
#include <stdio.h>
#include <stdlib.h>

FILE *stream;

int main( void )
{
   long l;
   float fp;
   char s[81];
   char c;

   errno_t err = fopen_s( &stream, "fscanf.out", "w+" );
   if( err )
      printf_s( "The file fscanf.out was not opened\n" );
   else
   {
      fprintf_s( stream, "%s %ld %f%c", "a-string", 
               65000, 3.14159, 'x' );
      // Set pointer to beginning of file:
      fseek( stream, 0L, SEEK_SET );

      // Read data back from file:
      fscanf_s( stream, "%s", s, _countof(s) );
      fscanf_s( stream, "%ld", &l );

      fscanf_s( stream, "%f", &fp );
      fscanf_s( stream, "%c", &c, 1 );

      // Output data read:
      printf( "%s\n", s );
      printf( "%ld\n", l );
      printf( "%f\n", fp );
      printf( "%c\n", c );

      fclose( stream );
   }
}