fprintf, _fprintf_l, fwprintf, _fwprintf_l

Articolo
03/05/2013

Dati formattati stampa in un flusso.Più versioni sicure di queste funzioni sono disponibili, 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 a FILE struttura.
format
stringa del Formato-controllo.
argument
argomenti facoltativi.
locale
le 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 anziché quando si verifica un errore di output si verifica.se stream o format viene NULL, queste funzioni richiamare il gestore non valido di parametro, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, le funzioni restituiscono -1 e impostate errno in EINVAL.La stringa di formato non viene verificata la presenza di caratteri di formattazione validi mentre è in caso di utilizzo fprintf_s o fwprintf_s.

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

Note

fprintf formatta e stampa una serie di caratteri e valori output stream*.* ogni funzione argument (se presenti) viene convertito e restituito in base alla specifica di formato corrispondente in format*.* per fprintf, format l'argomento è la stessa sintassi e l'utilizzo con in printf.

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

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.

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

Mapping di routine a testo generico

routine di 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 di associazione
fprintf, _fprintf_l	<stdio.h>
fwprintf, _fwprintf_l	<stdio.h> o <wchar.h>

per informazioni di compatibilità aggiuntive, 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" );
}