fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l_ftprintf, _ftprintf_l, , _ftprintf_s_ftprintf_s_l

Stampare dati formattati in un flusso. Queste funzioni sono versioni di fprintf, _fprintf_l, fwprintf, _fwprintf_l con miglioramenti della sicurezza, come descritto in Funzionalità di sicurezza in CRT.

Per _ftprintf_s e _ftprintf_s_l, vedere Mapping delle funzioni di testo generico.

Sintassi

int fprintf_s(
   FILE *stream,
   const char *format [,
   argument_list ]
);
int _fprintf_s_l(
   FILE *stream,
   const char *format,
   _locale_t locale [,
   argument_list ]
);
int fwprintf_s(
   FILE *stream,
   const wchar_t *format [,
   argument_list ]
);
int _fwprintf_s_l(
   FILE *stream,
   const wchar_t *format,
   _locale_t locale [,
   argument_list ]
);

Parametri

stream
Puntatore alla struttura FILE .

format
Stringa di controllo del formato.

argument_list
Argomenti facoltativi per la stringa di formato.

locale
Impostazioni locali da usare.

Valore restituito

fprintf_s restituisce il numero di byte scritti. fwprintf_s restituisce il numero di caratteri wide scritti. Ognuna di queste funzioni restituisce invece un valore negativo quando si verifica un errore di output.

Osservazioni:

La funzione fprintf_s formatta e stampa una serie di caratteri e di valori nell'elemento di output stream. Ogni argomento in argument_list (se presente) viene convertito e restituito in base alla specifica di formato corrispondente in format. L'argomento format usa la sintassi della specifica del formato per printf le funzioni e wprintf .

fwprintf_s è una versione a caratteri wide di fprintf_s. In fwprintf_s, format è una stringa di caratteri wide. Queste funzioni si comportano in modo identico se il flusso viene aperto in modalità ANSI. fprintf_s non supporta attualmente l'output in un flusso UNICODE.

Le versioni di queste funzioni con il suffisso _l sono identiche ad eccezione per il fatto che usano il parametro delle impostazioni locali passato al posto di quelle correnti.

Analogamente alle versioni non sicure (vedere fprintf, _fprintf_lfwprintf, , _fwprintf_l), queste funzioni convalidano i relativi parametri e richiamano il gestore di parametri non validi, come descritto in Convalida dei parametri, se stream o format è un NULL puntatore. Viene convalidata anche la stringa di formato stessa. Se sono presenti identificatori di formattazione sconosciuti o non corretti, queste funzioni generano l'eccezione di parametro non valido. In tutti casi, se l'esecuzione può continuare, le funzioni restituiscono -1 e impostano errno su EINVAL. Per altre informazioni sui codici restituiti, vedere errno, _doserrno, _sys_errliste _sys_nerr.

Mapping di funzioni di testo generico

La funzione nella tchar.h colonna esegue il mapping alla funzione nelle altre colonne a seconda del set di caratteri definito in fase di compilazione.

Per altre informazioni, vedere Sintassi delle specifiche di formato.

Requisiti

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Esempio

// crt_fprintf_s.c
// This program uses fprintf_s to format various
// data and print it to the file named FPRINTF_S.OUT. It
// then displays FPRINTF_S.OUT on the screen using the system
// function to invoke the operating-system TYPE command.

#include <stdio.h>
#include <process.h>

FILE *stream;

int main( void )
{
   int    i = 10;
   double fp = 1.5;
   char   s[] = "this is a string";
   char   c = '\n';

   fopen_s( &stream, "fprintf_s.out", "w" );
   fprintf_s( stream, "%s%c", s, c );
   fprintf_s( stream, "%d\n", i );
   fprintf_s( stream, "%f\n", fp );
   fclose( stream );
   system( "type fprintf_s.out" );
}

this is a string
10
1.500000

Vedi anche

I/O di flusso
_cprintf, _cprintf_l, _cwprintf_cwprintf_l
fscanf, _fscanf_l, fwscanf_fwscanf_l
sprintf, _sprintf_l, swprintf, _swprintf_l__swprintf_l