_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

  • Artigo

Formata e imprime no console. Versões mais seguras estão disponíveis; veja _cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l.

Importante

Esta API não pode ser usada em aplicativos executados no Windows Runtime. Para obter mais informações, confira Funções do CRT sem suporte em aplicativos da Plataforma Universal do Windows.

Sintaxe

int _cprintf(
   const char * format [, argument_list]
);
int _cprintf_l(
   const char * format,
   _locale_t locale [, argument_list]
);
int _cwprintf(
   const wchar * format [, argument_list]
);
int _cwprintf_l(
   const wchar * format,
   _locale_t locale [, argument_list]
);

Parâmetros

format
Cadeia de caracteres de controle de formato.

argument_list
Parâmetros opcionais para a cadeia de caracteres de formato.

locale
A localidade a ser usada.

Valor retornado

O número de caracteres impressos.

Comentários

Essas funções formatam e imprimem uma série de caracteres e valores diretamente no console, usando a função _putch (_putwch para _cwprintf) para gerar caracteres. Cada argumento em argument_list (se houver) é convertido e gerado de acordo com a especificação de formato correspondente em format. O format argumento usa a sintaxe de especificação de formato para funções printf e wprintf. Ao contrário das funções _cprintf _cwprintf , printf, e sprintf não convertem caracteres de alimentação de linha em combinações de alimentação de linha de retorno de carro (CR-LF) durante a fprintfsaída.

Uma distinção importante é que _cwprintf exibe caracteres Unicode quando usado no Windows. Ao contrário de _cprintf, _cwprintf usa as configurações de localidade do console atual.

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

_cprintf valida o parâmetro format. Se format for um ponteiro nulo, a função invocará o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro. Se a execução puder continuar, a função retornará um valor -1 e definirá errno como EINVAL.

Importante

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

Começando pelo Windows 10 versão 2004 (build 19041), a família de funções printf imprime números de ponto flutuante exatamente representáveis de acordo com as regras do IEEE 754 para arredondamento. Em versões anteriores do Windows, números de ponto flutuante que pudessem ser representados com exatidão e que terminassem em '5' eram sempre arredondados para cima. O IEEE 754 afirma que eles precisam arredondar para o dígito par mais próximo (também conhecido como "arredondamento bancário"). Por exemplo, ambos printf("%1.0f", 1.5) e printf("%1.0f", 2.5) devem ser arredondados para 2. Anteriormente, 1,5 seria arredondado para 2 e 2,5 para 3. Essa alteração afeta apenas números que possam ser representados com exatidão. Por exemplo, 2,35 (que, quando representado na memória, está mais próximo de 2,35000000000000008) 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 escolhia o comportamento FE_TONEAREST. Essa alteração afeta apenas os programas criados usando o Visual Studio 2019 versão 16.2 e posteriores. Para usar o comportamento de arredondamento de ponto flutuante herdado, vincule-o a legacy_stdio_float_rounding.obj.

Mapeamentos de rotina de texto genérico

Rotina Tchar.h _UNICODE e _MBCS não definidos _MBCS definido _UNICODE definido
_tcprintf _cprintf _cprintf _cwprintf
_tcprintf_l _cprintf_l _cprintf_l _cwprintf_l

Requisitos

Rotina Cabeçalho necessário
_cprintf, _cprintf_l <conio.h>
_cwprintf, _cwprintf_l <conio.h>

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

Exemplo

// crt_cprintf.c
// compile with: /c
// This program displays some variables to the console.

#include <conio.h>

int main( void )
{
    int         i = -16,
                h = 29;
    unsigned    u = 62511;
    char        c = 'A';
    char        s[] = "Test";

    // Note that console output does not translate \n as
    // standard output does. Use \r\n instead.
    //
    _cprintf( "%d  %.4x  %u  %c %s\r\n", i, h, u, c, s );
}

-16  001d  62511  A Test

Confira também

E/S de console e porta
_cscanf, _cscanf_l, _cwscanf, _cwscanf_l
fprintf, _fprintf_l, fwprintf, _fwprintf_l
printf, _printf_l, wprintf, _wprintf_l
sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l
vfprintf, _vfprintf_l, vfwprintf, _vfwprintf_l
_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l
_cprintf_p, _cprintf_p_l, _cwprintf_p, _cwprintf_p_l
Sintaxe de especificação de formato: printf e wprintf funções