_vcprintf_s, _vcprintf_s_l, _vcwprintf_s, _vcwprintf_s_l
Grave saída formatada para o console usando um ponteiro para uma lista de argumentos.Essas são sistema autônomo versões de _vcprintf, _vcprintf_l, _vcwprintf, _vcwprintf_l com aprimoramentos de segurança conforme descrito em Aprimoramentos de segurança no CRT.
int _vcprintf(
const char* format,
va_list argptr
);
int _vcprintf(
const char* format,
locale_t locale,
va_list argptr
);
int _vcwprintf_s(
const wchar_t* format,
va_list argptr
);
int _vcwprintf_s_l(
const wchar_t* format,
locale_t locale,
va_list argptr
);
Parâmetros
format
Especificação de formato.argptr
Ponteiro para a lista de argumentos.locale
A localidade para usar.
Para obter mais informações, consulte Especificações de formato.
Valor de retorno
O número de caracteres escritos, ou um valor negativo se ocorrer um erro de saída.
Versão dessas funções não seguras, sistema autônomo se format é um ponteiro nulo, o manipulador de parâmetro inválido é chamado, conforme descrito em Validação de parâmetro. Além disso, ao contrário da versão não-seguras dessas funções, se format não especifica um formato válido, será gerada uma exceção de parâmetro inválido. Se a execução terá permissão para continuar, essas funções retornam
Comentários
Cada uma dessas funções leva um ponteiro para uma lista de argumentos, e, em seguida, formata e grava os dados fornecidos o console._vcwprintf_s é a versão de caractere largo da _vcprintf_s. Ele tem uma seqüência de caractere a toda a sistema autônomo um argumento.
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. Para obter mais informações, consulte Evitar saturações de buffer. |
Mapeamentos de rotina de texto genérica
Rotina TCHAR.H |
_UNICODE & _MBCS não definido |
_MBCS definido |
_UNICODE definido |
---|---|---|---|
_vtcprintf_s |
_vcprintf_s |
_vcprintf_s |
_vcwprintf_s |
_vtcprintf_s_l |
_vcprintf_s_l |
_vcprintf_s_l |
_vcwprintf_s_l |
Requisitos
Rotina |
Cabeçalho necessário |
Cabeçalhos opcionais |
---|---|---|
_vcprintf_s, _vcprintf_s_l |
<conio.h> e <stdarg.h> |
<varargs.h> * |
_vcwprintf_s, _vcwprintf_s_l |
<conio.h> ou <wchar.h> e <stdarg.h> |
<varargs.h> * |
* Necessário para compatibilidade UNIX V.
Para obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.
Exemplo
// crt_vcprintf_s.cpp
#include <conio.h>
#include <stdarg.h>
// An error formatting function used to print to the console.
int eprintf_s(const char* format, ...)
{
va_list args;
va_start(args, format);
return _vcprintf_s(format, args);
}
int main()
{
eprintf_s(" (%d:%d): Error %s%d : %s\n", 10, 23, "C", 2111,
"<some error text>");
eprintf_s(" (Related to symbol '%s' defined on line %d).\n",
"<symbol>", 5 );
}
(10,23): Error C2111 : <some error text> (Related to symbol '<symbol>' defined on line 5).
Equivalente do NET Framework
Consulte também
Referência
_cprintf, _cprintf_l, _cwprintf, _cwprintf_l
fprintf, _fprintf_l, fwprintf, _fwprintf_l
printf, _printf_l, wprintf, _wprintf_l