vfprintf, _vfprintf_l, vfwprintf, _vfwprintf_l

Artigo
06/09/2015

A saída formatada de gravação usando um ponteiro para uma lista de argumentos. Existem versões mais seguras dessas funções; consulte vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l.

int vfprintf(
   FILE *stream,
   const char *format,
   va_list argptr 
);
int _vfprintf_l(
   FILE *stream,
   const char *format,
   locale_t locale,
   va_list argptr 
);
int vfwprintf(
   FILE *stream,
   const wchar_t *format,
   va_list argptr 
);
int _vfwprintf_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 e vfwprintf 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. Se stream ou format for um ponteiro nulo, o parâmetro de manipulador inválido será chamado, como 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.

Para obter informações sobre esses e outros códigos de erro, consulte _doserrno, errno, _sys_errlist, and _sys_nerr.

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.

vfwprintf é a versão de caracteres largos de vfprintf; as duas funções se comportarão de forma idêntica se o fluxo for aberto no modo de ANSI. No momento, vfprintf 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.

Mapeamentos da rotina de texto genérico

Rotina TCHAR.H	_UNICODE & _MBCS não definido	_MBCS definido	_UNICODE definido
_vftprintf	vfprintf	vfprintf	vfwprintf
_vftprintf_l	_vfprintf_l	_vfprintf_l	_vfwprintf_l

Requisitos

Rotina	Cabeçalho necessário	Cabeçalhos opcionais
vfprintf, _vfprintf_l	<stdio.h> e <stdarg.h>	<varargs.h>*
vfwprintf, _vfwprintf_l	<stdio.h> ou <wchar.h> e <stdarg.h>	<varargs.h>*

* Necessário para a compatibilidade de UNIX V.

Para informações adicionais de compatibilidade, consulte Compatibilidade na Introdução.

Equivalência do .NET Framework

Não aplicável. Para chamar a função padrão de C, use PInvoke. Para obter mais informações, consulte Exemplos de chamadas de plataformas.

Consulte também

Referência

E/S de fluxo

Funções vprintf

fprintf, _fprintf_l, fwprintf, _fwprintf_l

printf, _printf_l, wprintf, _wprintf_l

sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l

va_arg, va_copy, va_end, va_start

Compartilhar via