_fprintf_p, _fprintf_p_l, _fwprintf_p, _fwprintf_p_l

Imprime dados formatados em um fluxo.

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

Fluxo
Ponteiro para a estrutura FILE.

format
Cadeia de caracteres de controle de formato.

argument
Argumentos opcionais.

locale
A localidade a ser usada.

Valor Retornado

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

Comentários

_fprintf_p formata e imprime uma série de caracteres e valores no fluxo de saída. Cada argumento de função (se algum) é convertido e é produzido de acordo com a especificação de formato correspondente no formato. Por _fprintf_p, o argumento format tem a mesma sintaxe e uso que ele tem em _printf_p. Essas funções dão suporte a 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 Parâmetros posicionais printf_p.

_fwprintf_p é uma versão de caractere largo do _fprintf_p; no _fwprintf_p, format é uma cadeia de caracteres largos. Essas funções terão comportamento idêntico se o fluxo for aberto no modo ANSI. _fprintf_p atualmente não dá suporte à saída em um fluxo UNICODE.

As versões dessas funções com o sufixo _l são idênticas, exceto pelo fato de usarem o parâmetro de localidade passado em vez da localidade atual.

Importante

Verifique se format não é uma cadeia de caracteres definida pelo usuário.

A partir da Windows 10 2004 (build 19041), printf a família de funções imprime números de ponto flutuante exatamente representáveis de acordo com as regras do IEEE 754 para arredondamento. Nas versões anteriores do Windows, números de ponto flutuante exatamente representáveis terminando em '5' sempre arredondam para cima. O IEEE 754 afirma que eles devem arredondar para o dígito de mesmo valor mais próximo (também conhecido como "Arredondamento do Jogo"). Por exemplo, e printf("%1.0f", 1.5) devem printf("%1.0f", 2.5) arredondar para 2. Anteriormente, 1,5 arredondava para 2 e 2,5 arredondava para 3. Essa alteração afeta apenas números exatamente representáveis. Por exemplo, 2,35 (que, quando representado na memória, é mais próximo de 2,3500000000000008) continua arredondando para 2,4. O arredondamento feito por essas funções agora também respeita o modo de arredondamento de ponto flutuante definido por fesetround. Anteriormente, o arredondamento sempre escolhe o FE_TONEAREST comportamento. Essa alteração afeta apenas os programas criado usando Visual Studio 2019 versão 16.2 e posteriores. Para usar o comportamento de arredondamento de ponto flutuante herddo, vincule com 'legacy_stdio_float_rounding.obj'.

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âmetro inválido, conforme descrito em Validação de parâmetro, se fluxo ou formato for um ponteiro nulo ou se houver especificadores de formatação desconhecidos ou mal formados. Se a execução tiver permissão para continuar, as funções retornarão -1 e definirão errno como EINVAL.

Mapeamentos da rotina de texto genérico

Rotina Tchar.h _UNICODE e _MBCS não definidos _MBCS definido _UNICODE definido
_ftprintf_p _fprintf_p _fprintf_p _fwprintf_p
_ftprintf_p_l _fprintf_p_l _fprintf_p_l _fwprintf_p_l

Para obter mais informações, consulte Especificações de formato.

Requisitos

Função Cabeçalho necessário
_fprintf_p, _fprintf_p_l <stdio.h>
_fwprintf_p, _fwprintf_p_l <stdio.h> ou <wchar.h>

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

Consulte também

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