_fprintf_p, _fprintf_p_l, _ftprintf_p, _ftprintf_p_l, _fwprintf_p_fwprintf_p_l

Stampa i dati formattati in un flusso.

Per _ftprintf_p e _ftprintf_p_l, vedere Mapping delle funzioni di testo generico.

Sintassi

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 usare.

Valore restituito

_fprintf_p e _fwprintf_p restituiscono il numero di caratteri scritti o un valore negativo quando si verifica un errore di output.

Osservazioni:

La funzione _fprintf_p formatta e stampa una serie di caratteri e di valori nell'elemento di output stream. Ogni funzione argument (se presente) viene convertita e restituita in base alla specifica di formato corrispondente in format. Per _fprintf_p, l'argomento format ha la stessa sintassi di in _printf_p. Queste funzioni supportano parametri posizionali, vale a dire che l'ordine dei parametri usati dalla stringa di formato può essere modificato. Per altre informazioni sui parametri posizionali, vedere Parametri posizionali printf_p.

_fwprintf_p è una versione a caratteri wide di _fprintf_p. In _fwprintf_p, format è una stringa di caratteri 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 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_lqueste funzioni convalidano i relativi parametri e richiamano il gestore di parametri non validi, come descritto in Convalida dei parametri, se stream o format è un puntatore Null o se sono presenti identificatori di formattazione sconosciuti o non validi. Se l'esecuzione può continuare, le funzioni restituiranno -1 e imposteranno errno su EINVAL.

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_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" );
}

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
Parametri posizionali printf_p
_cprintf_p, _cprintf_p_l, _cwprintf_p_cwprintf_p_l
_cprintf_s, _cprintf_s_l, _cwprintf_s_cwprintf_s_l
Parametri posizionali printf_p
fscanf_s, _fscanf_s_l, fwscanf_s_fwscanf_s_l