vprintf_s, _vprintf_s_l, vwprintf_s, _vwprintf_s_l
Gravar saída formatados usando um ponteiro para uma lista de argumentos.Essas são versões de vprintf, _vprintf_l, vwprintf, _vwprintf_l com aprimoramentos de segurança conforme descrito em Recursos de segurança no CRT.
int vprintf_s( const char *format, va_list argptr ); int _vprintf_s_l( const char *format, locale_t locale, va_list argptr ); int vwprintf_s( const wchar_t *format, va_list argptr ); int _vwprintf_s_l( const wchar_t *format, locale_t locale, va_list argptr );
Parâmetros
format
Formatar a especificação.argptr
Ponteiro para a lista de argumentos.locale
A localidade a ser usada.
Para obter mais informações, consulte Especificações de formato.
Valor de retorno
vprintf_s e vwprintf_s retorna o número de caracteres gravados, não incluindo o caractere de terminação zero, ou um valor negativo se ocorrer um erro de saída.Se format é um ponteiro zero, ou se a cadeia de caracteres de formato de formatação contém caracteres inválidos, o manipulador inválido do parâmetro é invocado, como descrito em Validação de parâmetro.Se a execução é permitida continuar, funções e retornam -1 errno definido como EINVAL.
Para obter informações sobre esses e outros códigos de erro, consulte _doserrno, errno, _sys_errlist, e _sys_nerr.
Comentários
Cada uma dessas funções tem um ponteiro para um lista de argumentos, então os formatos e grava dados para os dados a stdout.
As versões seguros dessas funções diferem de vprintf e de vwprintf apenas as versões seguros verifica a cadeia de caracteres de formato contém caracteres de formatação válidos.
vwprintf_s é a versão do largo- caractere de vprintf_s; as duas funções se comportam de forma idêntica se o fluxo é aberta no modo ANSI.vprintf_s não tem suporte para a saída em um fluxo de UNICODE.
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 da thread.
Observação de segurança |
---|
Certifique-se de que format não é uma cadeia de caracteres definida pelo usuário.Para obter mais informações, consulte Evitando estouros de buffer. |
Mapeamentos da rotina de Genérico- texto
Rotina de TCHAR.H |
_UNICODE & _MBCS não definidos |
_MBCS definido |
_UNICODE definido |
---|---|---|---|
_vtprintf_s |
vprintf_s |
vprintf_s |
vwprintf_s |
_vtprintf_s_l |
_vprintf_s_l |
_vprintf_s_l |
_vwprintf_s_l |
Requisitos
Rotina |
Cabeçalho necessário |
Cabeçalhos opcionais |
---|---|---|
vprintf_s, _vprintf_s_l |
<stdio.h> e <stdarg.h> |
<varargs.h>* |
vwprintf_s, _vwprintf_s_l |
<stdio.h> ou <wchar.h>, e <stdarg.h> |
<varargs.h>* |
* Necessário para a compatibilidade de UNIX V.
O console não é suportado em aplicativos de Windows Store .Identificadores padrões de fluxo associadas ao console, stdin, stdout, e stderr, devem ser redirecionada antes que as funções de tempo de execução das C pode usar em aplicativos de Windows Store .Para informações extras de compatibilidade Compatibilidade na introdução, consulte.
Equivalência do .NET Framework
Consulte também
Referência
fprintf, _fprintf_l, fwprintf, _fwprintf_l
printf, _printf_l, wprintf, _wprintf_l