_fprintf_p, _fprintf_p_l, _ftprintf_p, _ftprintf_p_l, _fwprintf_p, _fwprintf_p_l

Imprime dados formatados em um fluxo.

Para _ftprintf_p e _ftprintf_p_l, consulte Mapeamentos de função de texto genérico.

Sintaxe

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 ]...
);

Parâmetros

stream
Ponteiro para a FILE estrutura.

format
Cadeia de caracteres de controle de formato.

argument
Argumentos opcionais.

locale
A localidade a ser usada.

Valor de retorno

_fprintf_p e _fwprintf_p retornar o número de caracteres gravados ou retornar um valor negativo quando ocorrer um erro de saída.

Observações

_fprintf_p formata e imprime uma série de caracteres e valores para a saída stream. Cada função argument (se houver) é convertida e saída de acordo com a especificação de formato correspondente em format. Para _fprintf_p, o format argumento tem a mesma sintaxe que tem em _printf_p. Essas funções suportam parâmetros posicionais, o que significa que a ordem dos parâmetros usados pela cadeia de caracteres de formato pode ser alterada. Para obter mais informações sobre parâmetros posicionais, consulte printf_p parâmetros posicionais.

_fwprintf_pé uma versão de caracteres largos de ; em _fwprintf_p, format é uma cadeia de _fprintf_pcaracteres largos. Essas funções se comportam de forma idêntica se o fluxo for aberto no modo ANSI. _fprintf_p atualmente não suporta saída em um fluxo UNICODE.

As versões dessas funções com o sufixo _l são idênticas, exceto que elas usam o parâmetro locale passado em vez da localidade atual.

Como as versões não seguras (consulte fprintf, _fprintf_l, fwprintf, _fwprintf_l), essas funções validam seus parâmetros e invocam o manipulador de parâmetros inválido, conforme descrito em Validação de parâmetros, se for streamformat um ponteiro nulo ou se houver algum especificador de formatação desconhecido ou mal formado. Se a execução for permitida para continuar, as funções retornarão -1 e definidas errno como EINVAL.

Mapeamentos de função de texto genérico

A função na coluna mapeia tchar.h para a função nas outras colunas, dependendo do conjunto de caracteres definido em tempo de compilação.

Para obter mais informações, consulte Sintaxe da especificação de formato.

Requerimentos

Para obter mais informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

// 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

Ver também

de E/S de fluxo
_cprintf, _cprintf_l, _cwprintf, _cwprintf_l
fscanf, _fscanf_l, fwscanf, _fwscanf_l
sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l
printf_p Parâmetros posicionais
_cprintf_p, _cprintf_p_l, _cwprintf_p, _cwprintf_p_l
_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l
printf_p Parâmetros posicionais
fscanf_s, _fscanf_s_l, fwscanf_s, _fwscanf_s_l