_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

Formatos e imprime no console.Versões mais seguros estão disponíveis; consulte _cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l.

Observação importanteImportante

Este API não pode ser usado em aplicativos executados em Tempo de Execução do Windows.Para obter mais informações, consulte Funções de CRT não suportadas com /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 formato - controle.

  • argument
    Parâmetros opcionais.

  • locale
    A localidade a ser usada.

Valor de retorno

O número de caracteres impressos.

Comentários

Essas funções de formataçãoe imprimem uma série de caracteres e valores diretamente para o console, usando a função de _putch (_putwch para _cwprintf) para caracteres de saída.Cada argument (se houver) é convertido e saída de acordo com a especificação correspondente de formato personalizado em format.O formato tem o mesmo formulário e função que o parâmetro de format para a função de printf .Ao contrário de fprintf, de printf, e funções de sprintf , nem nem _cprintf_cwprintf traduzirem caracteres de alimentação de linha na linha retorno- combinações de carro de avanço (CR-LF) quando saída.

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

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

_cprintf valida o parâmetro de format .Se format é um ponteiro zero, a função chama o manipulador de parâmetro inválido, como descrito em Validação de parâmetro.Se a execução é permitida continuar, a função retorna -1 e defina errno a EINVAL.

Observação de segurançaObservação de segurança

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

Mapeamentos da rotina de Genérico- texto

Rotina de Tchar.h

_UNICODE e não definidos _MBCS

_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 mais informações, consulte Compatibilidade de compatibilidade na introdução.

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

Equivalência do .NET Framework

Não aplicável. Para chamar a função padrão de C, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.

Consulte também

Referência

Console e a porta de e/S

_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: funções printf e and wprintf