fscanf_s, _fscanf_s_l, fwscanf_s, _fwscanf_s_l

Articolo
03/05/2013

Dati formattati letti da un flusso.queste sono versioni di fscanf, _fscanf_l, fwscanf, _fwscanf_l con i miglioramenti della sicurezza come descritto in Funzionalità di sicurezza in 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 ]... 
);

Parametri

stream
puntatore a FILE struttura.
format
stringa del Formato-controllo.
argument
argomenti facoltativi.
locale
le impostazioni locali da utilizzare.

Valore restituito

Ognuna di queste funzioni restituisce il numero di campi correttamente conversione e assegnati; il valore restituito non include campi che sono stati letti ma non assegnato.Un valore restituito pari a 0 indica che nessun campo è stato assegnato.Se si verifica un errore, o se la fine del flusso di file viene raggiunta prima della prima conversione, il valore restituito è EOF per fscanf_s e fwscanf_s.

Queste funzioni convalidano i relativi parametri.Se il flusso è puntatore del file di nvalid di ian, o format è un puntatore null, queste funzioni viene richiamato il gestore non valido di parametro, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, ritorno di queste funzioni EOF e set errno in EINVAL.

Note

fscanf_s la funzione legge i dati dalla posizione corrente di stream nelle posizioni fornite da argument (se presente).ciascuno argument deve essere un puntatore a una variabile di un tipo che corrisponde a un identificatore del tipo in format.format controlla interpretazione dei campi di input e presenta lo stesso form e di funzione format argomento per scanf_s; vedere La specifica di formato sistema - funzioni denominate scanf e funzioni del wscanf per una descrizione di format.fwscanf_s è una versione a caratteri estesi di fscanf_s; l'argomento format afwscanf_s è una stringa di caratteri estesi.Queste funzioni si comportano in modo identico se il flusso viene aperto in modalità ANSI.fscanf_s non supporta attualmente l'input da un flusso di UNICODE.

La differenza principale tra le funzioni protette (con _sil suffisso) e le funzioni precedenti è che le funzioni protette richiedono la dimensione dei caratteri di ogni c, C, s, Se [ digitare il campo da passare come argomento immediatamente dopo la variabile.Per ulteriori informazioni, vedere scanf_s, _scanf_s_l, wscanf_s, _wscanf_s_l e specifica la larghezza di scanf.

[!NOTA]

il parametro di dimensione è di tipo unsigned, non size_t.

le versioni di queste funzioni con _l il suffisso è identico con la differenza che utilizzano il parametro delle impostazioni locali passato alle impostazioni locali del thread corrente.

Mapping di routine a testo generico

routine di TCHAR.H	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_ftscanf_s	fscanf_s	fscanf_s	fwscanf_s
_ftscanf_s_l	_fscanf_s_l	_fscanf_s_l	_fwscanf_s_l

Requisiti

Funzione	Intestazione di associazione
fscanf_s, _fscanf_s_l	<stdio.h>
fwscanf_s, _fwscanf_s_l	<stdio.h> o <wchar.h>

per informazioni di compatibilità aggiuntive, vedere compatibilità nell'introduzione.

Esempio

// 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 );
   }
}