fscanf_s、 _fscanf_s_l、 fwscanf_s、 _fwscanf_s_l

發行項
02/28/2013

讀取的格式從資料流的資料。這些是舊版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 表示沒有欄位被指定。如果發生錯誤，或如果第一個轉換就到檔案資料流末端，傳回的值是EOF的fscanf_s和fwscanf_s。

這些函式會驗證它們的參數。如果資料流伊恩 ‧ 無效檔案指標，或format是空值的指標，如所述，這些函式叫用無效的參數處理常式中，參數驗證。如果執行則允許繼續執行，則這些函數會傳回EOF ，並設定errno到EINVAL。

備註

fscanf_s函式會讀取目前的位置中的資料stream到所指定的位置argument (如果有的話)。每個argument必須是變數的指標，會對應到中的型別規範型別的變數format。 format控制項的欄位輸入的轉譯工作，並具有相同構成和運作format引數的scanf_s。請參閱格式規格欄位 – scanf 函式和 wscanf 函數的說明format*.*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 );
   }
}