fprintf, _fprintf_l, fwprintf, _fwprintf_l

Articolo
06/09/2015

Stampare dati formattati in un flusso. Sono disponibili versioni più sicure di queste funzioni. Vedere fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l.

int fprintf( 
   FILE *stream,
   const char *format [,
   argument ]...
);
int _fprintf_l( 
   FILE *stream,
   const char *format,
   locale_t locale [,
   argument ]...
);
int fwprintf( 
   FILE *stream,
   const wchar_t *format [,
   argument ]...
);
int _fwprintf_l( 
   FILE *stream,
   const wchar_t *format,
   locale_t locale [,
   argument ]...
);

Parametri

stream
Puntatore alla struttura FILE.
format
Stringa di controllo del formato.
argument
Argomenti facoltativi.
locale
Impostazioni locali da utilizzare.

Valore restituito

fprintf restituisce il numero di byte scritti. fwprintf restituisce il numero di caratteri di tipo "wide" scritti. Ognuna di queste funzioni restituisce un valore negativo quando si verifica un errore di output. Se il stream o format è NULL, queste funzioni richiamano il gestore di parametro non valido, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, la funzione restituisce -1 e imposta errno a EINVAL. Non viene controllato che la stringa di formato abbia dei caratteri di formattazione validi, come invece accade con fprintf_s o fwprintf_s.

Vedere _doserrno, errno, _sys_errlist, e _sys_nerr per ulteriori informazioni su questi, e altri, codici di errore.

Note

fprintf formatta e visualizza una stringa di caratteri e di valori nello streamdi output*.* Ogni funzione argument (se presente) viene convertita e restituita in base al formato specificato in format*.* Per fprintf, l'argomento format ha la stessa sintassi e la stessa funzione che ha in printf.

fwprintf è una versione a caratteri di tipo "wide" di fprintf; in fwprintf, format è una stringa di caratteri di tipo "wide". Queste funzioni si comportano in modo identico se il flusso viene aperto in modalità ANSI. fprintf 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 utilizzano il parametro delle impostazioni locali passato al posto di quelle del thread corrente.

Nota sulla sicurezza
Assicurarsi che format non sia una stringa definita dall'utente.

Mapping di routine di testo generico

Routine TCHAR.H	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_ftprintf	fprintf	fprintf	fwprintf
_ftprintf_l	_fprintf_l	_fprintf_l	_fwprintf_l

Per ulteriori informazioni, vedere Specifiche di formato.

Requisiti

Funzione	Intestazione obbligatoria
fprintf, _fprintf_l	<stdio.h>
fwprintf, _fwprintf_l	<stdio.h> o <wchar.h>

Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'Introduzione.

Esempio

// crt_fprintf.c
/* This program uses fprintf to format various
 * data and print it to the file named FPRINTF.OUT. It
 * then displays FPRINTF.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.out", "w" );
   fprintf( stream, "%s%c", s, c );
   fprintf( stream, "%d\n", i );
   fprintf( stream, "%f\n", fp );
   fclose( stream );
   system( "type fprintf.out" );
}