_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.
Importante |
---|
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ç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
_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