_vscprintf, _vscprintf_l, _vscwprintf, _vscwprintf_l

Artigo
08/25/2010

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

Parâmetros

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.

Valor de retorno

_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.

Comentários

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.