vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l

Artigo
06/09/2015

A saída formatada de gravação usando um ponteiro para uma lista de argumentos. Essas são as versões de vfprintf, _vfprintf_l, vfwprintf, _vfwprintf_l com aprimoramentos de segurança, como descrito em Recursos de segurança no CRT.

int vfprintf_s(
   FILE *stream,
   const char *format,
   va_list argptr 
);
int _vfprintf_s_l(
   FILE *stream,
   const char *format,
   locale_t locale,
   va_list argptr 
);
int vfwprintf_s(
   FILE *stream,
   const wchar_t *format,
   va_list argptr 
);
int _vfwprintf_s_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_s e vfwprintf_s 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, 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.

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.

Essas funções são diferentes das versões de não seguras que somente as versões seguros verifica se a cadeia de caracteres de format contém caracteres de formatação válidos.

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

Requisitos

Rotina	Cabeçalho necessário	Cabeçalhos opcionais
vfprintf_s, _vfprintf_s_l	<stdio.h> e <stdarg.h>	<varargs.h>*
vfwprintf_s, _vfwprintf_s_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