_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

Artigo
06/09/2015

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

Importante

Esta API não pode ser usada em aplicativos que executam no Tempo de Execução do Windows.Para obter mais informações, consulte Funções CRT sem suporte pelo /ZW.

int _cprintf( 
   const char * format [, 
   argument] ... 
);
int _cprintf_l( 
   const char * format,
   locale_t locale [,
   argument] … 
);
int _cwprintf(
   const wchar * format [, 
   argument] …
);
int _cwprintf_l(
   const wchar * format,
   locale_t locale [, 
   argument] …
);

Parâmetros

format
Cadeia de caracteres de controle de formato.
argument
Parâmetros opcionais.
locale
A localidade a ser usada.

Valor de retorno

O número de caracteres impressos.

Comentários

Essas funções formatam e imprimem uma série de caracteres e valores diretamente para o console, usando a função _putch (_putwch para _cwprintf) para caracteres de saída. Cada argument (se houver) é convertido e gerado de acordo com a especificação de formato correspondente em format. O formato tem o mesmo formulário e a mesma função que o parâmetro format para a função printf. Ao contrário, as funções de fprintf, de printf e sprintf ou _cprintf ou _cwprintf traduz caracteres de alimentação de linha em combinações de alimentação da linha de retorno de transporte (CR-LF) na saída.

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

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

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

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

Mapeamentos da 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 mais 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 );
}