fprintf, _fprintf_l, fwprintf, _fwprintf_l, _ftprintf, _ftprintf_l

Imprima dados formatados em um fluxo. Estão disponíveis versões mais seguras destas funções; ver fprintf_s, _fprintf_s_l, , fwprintf_s_fwprintf_s_l.

Para _ftprintf e _ftprintf_l, consulte Mapeamentos de função de texto genérico.

Sintaxe

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

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 Retorna o número de bytes gravados. fwprintf Retorna o número de caracteres largos gravados. Cada uma dessas funções retorna um valor negativo quando ocorre um erro de saída. Se stream ou format for NULL, essas funções invocam o manipulador de parâmetros inválido, conforme descrito em Validação de parâmetros. Se a execução for permitida para continuar, as funções retornarão -1 e definidas errno como EINVAL. A cadeia de caracteres de formato não é verificada quanto a caracteres de formatação válidos como é ao usar fprintf_s ou fwprintf_s.

Para obter mais informações sobre códigos de retorno, consulte errno, _doserrno, _sys_errliste _sys_nerr.

Observações

fprintf 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, o format argumento tem a mesma sintaxe que tem em printf.

fwprintfé uma versão de caracteres largos de ; em fwprintf, format é uma cadeia de fprintfcaracteres largos. Essas funções se comportam de forma idêntica se o fluxo for aberto no modo ANSI. fprintf 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 thread atual.

Importante

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

A partir do Windows 10 versão 2004 (build 19041), a família de funções imprime printf números de ponto flutuante exatamente representáveis de acordo com as regras IEEE 754 para arredondamento. Em versões anteriores do Windows, números de ponto flutuante exatamente representáveis terminando em '5' sempre arredondavam para cima. IEEE 754 afirma que eles devem arredondar para o dígito par mais próximo (também conhecido como "Arredondamento do Banqueiro"). Por exemplo, ambos printf("%1.0f", 1.5) e printf("%1.0f", 2.5) deve arredondar para 2. Anteriormente, 1,5 arredondava para 2 e 2,5 arredondava para 3. Esta alteração afeta apenas números exatamente representáveis. Por exemplo, 2.35 (que, quando representado na memória, está mais próximo de 2.35000000000000008) continua a arredondar para 2.4. O arredondamento feito por essas funções agora também respeita o modo de arredondamento de ponto flutuante definido pela fesetround. Anteriormente, o arredondamento sempre escolhia o FE_TONEAREST comportamento. Essa alteração afeta apenas os programas criados usando o Visual Studio 2019 versão 16.2 e posterior. Para usar o comportamento de arredondamento de ponto flutuante herdado, vincule-se a legacy_stdio_float_rounding.obj.

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.

tchar.h Função	_UNICODE e _MBCS não definidos	_MBCS definido	_UNICODE definido
_ftprintf	fprintf	fprintf	fwprintf
_ftprintf_l	_fprintf_l	_fprintf_l	_fwprintf_l

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

Requerimentos

Função	Cabeçalho obrigatório
fprintf, _fprintf_l	<stdio.h>
fwprintf, _fwprintf_l	<stdio.h> ou <wchar.h>

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

Exemplo

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

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
Sintaxe da especificação do formato: printf e wprintf funções