_vscprintf, _vscprintf_l, _vscwprintf, _vscwprintf_l

Artigo
06/09/2015

Retorna o número de caracteres na cadeia 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 
);

Parâmetros

format
Cadeia de caracteres de controle de formato.
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

_vscprintf retorna o número de caracteres que serão gerados se a cadeia de caracteres apontada pela lista de argumentos foi impressa ou enviada a um arquivo ou um buffer usando os códigos de formatação especificados. O valor retornado não inclui o caractere nulo sendo encerrado. _vscwprintf executa a mesma função para caracteres amplos.

As versões dessas funções com o sufixo _l são idênticas, exceto que usam o parâmetro de localidade passado em vez da localidade de thread atual.

Se format for um ponteiro nulo, o manipulador de parâmetro inválido será chamado, como descrito em Validação do parâmetro. Se a execução puder continuar, as funções retornarão -1 e definirão errno como EINVAL.

Comentários

Cada argument (se houver) é convertido de acordo com a especificação de formato correspondente em format. O formato consiste em caracteres comuns e tem o mesmo formato e função do que o argumento format para printf.

Observação de segurança
Certifique-se de que se format é uma cadeia de caracteres definida pelo usuário, é encerrada e zero tenha-se o número e o tipo de parâmetros corretos.Para obter mais informações, consulte Evitando saturações de buffer.