fscanf、 _fscanf_l、 fwscanf、 _fwscanf_l

發行項
02/28/2013

讀取的格式從資料流的資料。這些函式更安全版本都可使用; see fscanf_s、 _fscanf_s_l、 fwscanf_s、 _fwscanf_s_l.

int fscanf( 
   FILE *stream,
   const char *format [,
   argument ]... 
);
int _fscanf_l( 
   FILE *stream,
   const char *format,
   locale_t locale [,
   argument ]... 
);
int fwscanf( 
   FILE *stream,
   const wchar_t *format [,
   argument ]... 
);
int _fwscanf_l( 
   FILE *stream,
   const wchar_t *format,
   locale_t locale [,
   argument ]... 
);

參數

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

傳回值

每個函式傳回的欄位順利轉換，並指派; 傳回的值不包括讀取但未指定的欄位。傳回值 0 表示沒有欄位被指定。如果發生錯誤，或如果第一個轉換就到檔案資料流末端，傳回的值是EOF的fscanf和fwscanf。

這些函式會驗證它們的參數。如果stream或format是空值的指標，不正確的參數處理常式會叫用，如所述參數驗證。如果執行則允許繼續執行，則這些函數會傳回EOF ，並設定errno到EINVAL。

備註

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

fwscanf寬字元版本的fscanf。格式引數，以fwscanf是寬字元字串。在 ANSI 模式中開啟資料流時，這些函式的行為完全相同。 fscanf目前不支援 UNICODE 資料流的意見。

使用這些函式的版本_l尾碼完全相同，不同之處在於它們使用傳遞中而不是目前執行緒的地區設定的地區設定參數。

泛用文字常式對應

TCHAR。H 常式	_UNICODE & 未定義的 _MBCS	定義的 _MBCS	定義 _unicode 之後
_ftscanf	fscanf	fscanf	fwscanf
_ftscanf_l	_fscanf_l	_fscanf_l	_fwscanf_l

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

需求

Function	所需的標頭
fscanf, _fscanf_l	<stdio.h>
fwscanf, _fwscanf_l	<stdio.h> 或者 <wchar.h>

其他的相容性資訊，請參閱相容性在簡介中。

範例

// crt_fscanf.c
// compile with: /W3
// This program writes formatted
// data to a file. It then uses fscanf to
// read the various data back from the file.
 
#include <stdio.h>

FILE *stream;

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

   if( fopen_s( &stream, "fscanf.out", "w+" ) != 0 )
      printf( "The file fscanf.out was not opened\n" );
   else
   {
      fprintf( stream, "%s %ld %f%c", "a-string", 
               65000, 3.14159, 'x' );
      // Security caution!
      // Beware loading data from a file without confirming its size,
      // as it may lead to a buffer overrun situation.

      // Set pointer to beginning of file:
      fseek( stream, 0L, SEEK_SET );

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

      fscanf( stream, "%f", &fp ); // C4996
      fscanf( stream, "%c", &c );  // C4996
      // Note: fscanf is deprecated; consider using fscanf_s instead

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

      fclose( stream );
   }
}