_vscprintf_p, _vscprintf_p_l, _vscwprintf_p, _vscwprintf_p_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, com a capacidade de especificar a ordem em que os argumentos são usados.

int _vscprintf_p(
   const char *format,
   va_list argptr 
);
int _vscprintf_p _l(
   const char *format,
   locale_t locale,
   va_list argptr 
);
int _vscwprintf_p (
   const wchar_t *format,
   va_list argptr 
);
int _vscwprintf_p _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.

Valor de retorno

_vscprintf_p 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_p executa a mesma função de caracteres largos.

Comentários

Essas funções diferem _vscprintf e _vscwprintf somente no que eles oferecem suporte à capacidade de especificar a ordem na qual os argumentos são usados. For more information, see printf_p posicional parâmetros.

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.

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.