Partilhar via


_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

Os formatos e imprime no console.Versões mais seguras disponível; consulte _cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l.

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
    Seqüência de caracteres de controle de formato.

  • argument
    Parâmetros opcionais.

  • locale
    A localidade para usar.

Valor de retorno

O número de caracteres é impresso.

Comentários

Esses funções de formatar e imprimir uma série de caracteres e valores diretamente ao console, usando o _putch (função_putwch para _cwprintf) para caracteres de saída. Cada argument (se houver) é convertido e saída de acordo com a especificação de formato correspondente em format. O formato tenha o mesmo formulário e função sistema autônomo a format parâmetro para o printf função.Ao contrário de fprintf, printf, e sprintf funciona, nem _cprintf nem _cwprintf Converte caracteres de avanço de linha em return–line de carro (CR-LF) combinações de feed durante a impressão.

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

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

_cprintf valida a format parâmetro. If format é um ponteiro nulo, a função chama o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro. Se a execução for permitida para continuar, a função retorna -1 e define errno para EINVAL.

Observação de segurança:

Certifique-se de que format não é uma seqüência de caracteres definida pelo usuário.

Mapeamentos de rotina de texto genérica

Rotina tchar.h

_UNICODE e _MBCS não definido

_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 de compatibilidade, consulte 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 );
}

-16  001d  62511  A Test

Equivalente do NET Framework

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

Consulte também

Referência

Console e 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