_vscprintf, _vscprintf_l, _vscwprintf, _vscwprintf_l
Retorna o número de caracteres na seqüência de caracteres formatada usando um ponteiro para uma lista de argumentos.
int _vscprintf(
const char *format,
va_list argptr
);
int _vscprintf_l(
const char *format,
locale_t locale,
va_list argptr
);
int _vscwprintf(
const wchar_t *format,
va_list argptr
);
int _vscwprintf_l(
const wchar_t *format,
locale_t locale,
va_list argptr
);
format
Seqüência de caracteres de controle de formato.argptr
Ponteiro para a lista de argumentos.locale
A localidade para usar.
Para obter mais informações, consulte Especificações de formato.
_vscprintf Retorna o número de caracteres seria gerado se a seqüência de caracteres apontada pela lista de argumentos foi impresso ou enviado para um arquivo ou o buffer usando os códigos de formatação especificados. O valor retornado não inclui o caractere nulo de terminação._vscwprintf executa a mesma função de caracteres largos.
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 do thread corrente.
If format é um ponteiro nulo, o manipulador de parâmetro inválido é chamado, conforme descrito em Validação de parâmetro. Se a execução for permitida para continuar, as funções retornam -1 e conjunto errno para EINVAL.
Cada argument (se houver) convertidas de acordo com a especificação de formato correspondente em format. O formato consiste em caracteres comuns e tenha o mesmo formulário e funcione sistema autônomo a format argumento para printf.
Observação de segurança: |
---|
Certifique-se de que, se format é uma seqüência de caracteres definida pelo usuário, ele é terminada nula e tem o número correto e o tipo de parâmetros. 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 |
---|---|---|---|
_vsctprintf |
_vscprintf |
_vscprintf |
_vscwprintf |
_vsctprintf_l |
_vscprintf_l |
_vscprintf_l |
_vscwprintf_l |
Rotina |
Cabeçalho necessário |
---|---|
_vscprintf, _vscprintf_l |
<stdio.h> |
_vscwprintf, _vscwprintf_l |
<stdio.h> ou <wchar.h> |
Para obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.
Consulte o exemplo para vsprintf.
fprintf, _fprintf_l, fwprintf, _fwprintf_l
printf, _printf_l, wprintf, _wprintf_l
scanf, _scanf_l, wscanf, _wscanf_l