_vfprintf_p, _vfprintf_p_l, _vfwprintf_p, _vfwprintf_p_l

Artigo
06/09/2015

Grava a 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 cadeia de caracteres de formato.

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 a estrutura de FILE .
format
Especificação 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

_vfprintf_p e _vfwprintf_p retornam o número de caracteres gravados, sem incluir o caractere nulo de terminação ou um valor negativo, no caso de ocorrer um erro de saída.

Comentários

Cada uma dessas funções leva um ponteiro a uma lista de argumentos e, em seguida, formata e grava os dados fornecidos em stream. Essas funções são diferentes das versões de _vfprint_s e de _vfwprint_s somente que oferecem suporte a parâmetros posicionais. Para obter mais informações, consulte Parâmetros posicionais printf_p.

_vfwprintf_p é a versão de caracteres largos de _vprintf_p; as duas funções se comportarão de forma idêntica se o fluxo for aberto no modo de ANSI. No momento, _vprintf_p não tem suporte para saída em fluxo UNICODE.

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.

Observação de segurança
Verifique se format não é uma cadeia de caracteres definida pelo usuário.Para obter mais informações, consulte Evitando saturações de buffer.

Se stream ou format for um ponteiro nulo, ou se a cadeia de formato contiver caracteres de formatação inválidos, o manipulador inválido do parâmetro será chamado, conforme 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.

Mapeamentos da rotina de texto genérico