_vprintf_p, _vprintf_p_l, _vwprintf_p, _vwprintf_p_l

Artigo
08/25/2010

Grave saída formatada usando um ponteiro para uma lista de argumentos, com a capacidade de especificar a ordem em que os argumentos são usados.

int _vprintf_p(
   const char *format,
   va_list argptr 
);
int _vprintf_p_l(
   const char *format,
   locale_t locale,
   va_list argptr 
);
int _vwprintf_p(
   const wchar_t *format,
   va_list argptr 
);
int _vwprintf_p_l(
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

Parâmetros

format
Especificação de formato.
argptr
Ponteiro para a lista de argumentos.
locale
A localidade para usar.

Valor de retorno

_vprintf_p e _vwprintf_p Retorna o número de caracteres escritos, não incluindo o caractere nulo de terminação ou um valor negativo se ocorrer um erro de saída.

Comentários

Cada uma dessas funções leva um ponteiro para uma lista de argumentos, em seguida, formata e grava os dados fornecidos stdout. Essas funções diferem vprintf_s e vwprintf_s 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.

_vwprintf_p é a versão de caractere largo da _vprintf_p; as duas funções tenham comportamento idêntico se o fluxo é aberto no modo ANSI. _vprintf_p atualmente não suporta saída em um fluxo UNICODE.

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.

Observação de segurança:
Certifique-se de que format não é uma seqüência de caracteres definida pelo usuário. Para obter mais informações, consulte Evitar saturações de buffer.

If format é um ponteiro nulo ou se a seqüência de caracteres de formato contém caracteres inválidos de formatação, o manipulador de parâmetro inválido é chamado, sistema autônomo 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.

Mapeamentos de rotina de texto genérica