_fprintf_p, _fprintf_p_l, _fwprintf_p, _fwprintf_p_l

Articolo
06/09/2015

Stampa dati formattati in un flusso.

int _fprintf_p( 
   FILE *stream,
   const char *format [,
   argument ]...
);
int _fprintf_p_l( 
   FILE *stream,
   const char *format,
   locale_t locale [,
   argument ]...
);
int _fwprintf_p( 
   FILE *stream,
   const wchar_t *format [,
   argument ]...
);
int _fwprintf_p_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_p e _fwprintf_p restituiscono il numero di caratteri scritto oppure restituiscono un valore negativo quando si verifica un errore di output.

Note

_fprintf_p 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_p, l'argomento format ha la stessa sintassi e la stessa funzione che ha in _printf_p. Queste funzioni supportano i parametri posizionali, pertanto l'ordine dei parametri utilizzati dalla stringa di formato può essere modificato. Per ulteriori informazioni sui parametri posizionali, vedere Parametri posizionali printf_p.

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

Le versioni di queste funzioni con il suffisso _l sono identiche ad eccezione che utilizzano il parametro delle impostazioni locali passato in ingresso invece di utilizzare le impostazioni locali correnti.

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

Come le versioni non sicure (vedere fprintf, _fprintf_l, fwprintf, _fwprintf_l), queste funzioni convalidano i relativi parametri e richiamano il gestore del parametro non valido, come descritto in Convalida dei parametri, se stream o format è un puntatore null o se ci sono identificatori di formattazione sconosciuti o mal formati. Se l'esecuzione può continuare, la funzione restituisce -1 e imposta errno a EINVAL.

Mapping di routine di testo generico

Routine Tchar.h	_UNICODE e _MBCS non definiti	_MBCS definito	_UNICODE definito
_ftprintf_p	_fprintf_p	_fprintf_p	_fwprintf_p
_ftprintf_p_l	_fprintf_p_l	_fprintf_p_l	_fwprintf_p_l

Per ulteriori informazioni, vedere Specifiche di formato.

Requisiti

Funzione	Intestazione obbligatoria
_fprintf_p, _fprintf_p_l	<stdio.h>
_fwprintf_p, _fwprintf_p_l	<stdio.h> o <wchar.h>

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

Esempio

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

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


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

    // Open the file
    if ( fopen_s( &stream, "fprintf_p.out", "w" ) == 0)
    {
        // Format and print data
        _fprintf_p( stream, "%2$s%1$c", c, s );
        _fprintf_p( stream, "%d\n", i );
        _fprintf_p( stream, "%f\n", fp );

        // Close the file
        fclose( stream );
    }

    // Verify our data
    system( "type fprintf_p.out" );
}