_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l

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

Saída

-16  001d  62511  A Test

Consulte também

Referência

Console e porta de E/s

_cscanf, _cscanf_l, _cwscanf, _cwscanf_l

fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l

printf_s, _printf_s_l, wprintf_s, _wprintf_s_l

sprintf_s, _sprintf_s_l, swprintf_s, _swprintf_s_l

vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l