_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l

Artigo
08/25/2010

Os formatos e imprime no console.Essas são sistema autônomo versões de _cprintf, _cprintf_l, _cwprintf, _cwprintf_l com aprimoramentos de segurança conforme descrito em Aprimoramentos de segurança no CRT.

int _cprintf_s( 
   const char * format [, 
   argument] ... 
);
int _cprintf_s_l( 
   const char * format,
   locale_t locale [, 
   argument] ... 
);
int _cwprintf_s(
   const wchar * format [, 
   argument] ...
);
int _cwprintf_s_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

Essas funções Formatar e imprimir uma série de caracteres e valores diretamente ao console, usando o _putch (função_putwch para _cwprintf_s) 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_s função.Ao contrário de fprintf_s, printf_s, e sprintf_s funciona, nem _cprintf_s nem _cwprintf_s 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_s Exibe caracteres Unicode quando usado no Windows NT. Ao contrário de _cprintf_s, _cwprintf_s usa a 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.

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

sistema autônomo sistema autônomo versões não seguras (consulte _cprintf, _cprintf_l, _cwprintf, _cwprintf_l), essas funções validar seus parâmetros e chamar o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro, se format é um ponteiro nulo. Essas funções diferem das versões não seguras, a seqüência de formato também é validada.Se houver qualquer especificadores de formatação de formato incorreto ou desconhecidos, essas funções chamam o manipulador de parâmetro inválido.Em todos os casos, se a execução terá permissão para continuar, as funções retornam -1 e conjunto errno para EINVAL.

Mapeamentos de rotina de texto genérica

Rotina tchar.h	_UNICODE e _MBCS não definido	_MBCS definido	_UNICODE definido
_tcprintf_s	_cprintf_s	_cprintf_s	_cwprintf_s
_tcprintf_s_l	_cprintf_s_l	_cprintf_s_l	_cwprintf_s_l

Requisitos

Rotina	Cabeçalho necessário
_cprintf_s, _cprintf_s_l	<conio.h>
_cwprintf_s, _cwprintf_s_l	<conio.h>

Para obter mais informações de compatibilidade, consulte Compatibilidade na introdução.

Bibliotecas

Todas as versões do C em time de execução bibliotecas.

Exemplo

// crt_cprintf_s.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_s( "%d  %.4x  %u  %c %s\r\n", i, h, u, c, s );
}