_vfprintf_p, _vfprintf_p_l, _vfwprintf_p, _vfwprintf_p_l

Artigo
02/25/2013

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 na seqüência de formato de gravação.

int _vfprintf_p(
   FILE *stream,
   const char *format,
   va_list argptr 
);
int _vfprintf_p_l(
   FILE *stream,
   const char *format,
   locale_t locale,
   va_list argptr 
);
int _vfwprintf_p(
   FILE *stream,
   const wchar_t *format,
   va_list argptr 
);
int _vfwprintf_p_l(
   FILE *stream,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

Parâmetros

stream
Ponteiro para FILE estrutura.
format
Especificação 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

_vfprintf_pe _vfwprintf_p retornar o número de caracteres gravados, 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 para stream.Essas funções diferem do _vfprint_s e _vfwprint_s versões somente no que eles oferecem suporte a parâmetros posicionais.Para obter mais informações, consulte printf_p parâmetros posicional.

_vfwprintf_pé a versão de caractere largo da _vprintf_p; as duas funções se comportar de forma idêntica se o fluxo é aberto no modo ANSI._vprintf_patualmente não suporta a saída em um fluxo UNICODE.

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

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

Se qualquer um dos stream ou 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 é invocado, conforme descrito em Validação de parâmetro.Se a execução terá permissão para continuar, as funções retornam -1 e defina errno para EINVAL.

Mapeamentos de rotina de texto genérico