Partilhar via


_vfprintf_p, _vfprintf_p_l, _vfwprintf_p, _vfwprintf_p_l

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 na seqüência 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 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_p e _vfwprintf_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 stream. Essas funções diferem o _vfprint_s e _vfwprint_s as versões apenas que eles oferecem suporte a parâmetros posicionais. For more information, see printf_p posicional parâmetros.

_vfwprintf_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.

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 é 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

Rotina TCHAR.H

_UNICODE & _MBCS não definido

_MBCS definido

_UNICODE definido

_vftprintf_p

_vfprintf_p

_vfprintf_p

_vfwprintf_p

_vftprintf_p_l

_vfprintf_p_l

_vfprintf_p_l

_vfwprintf_p_l

Requisitos

Rotina

Cabeçalho necessário

Cabeçalhos opcionais

_vfprintf_p, _vfprintf_p_l

<stdio.h> e <stdarg.h>

<varargs.h> *

_vfwprintf_p, _vfwprintf_p_l

<stdio.h> ou <wchar.h> e <stdarg.h>

<varargs.h> *

* Necessário para compatibilidade UNIX V.

Para obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.

Equivalente do NET Framework

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

Consulte também

Referência

Fluxo de E/S

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_end, va_start

printf_p posicional parâmetros

_fprintf_p, _fprintf_p_l, _fwprintf_p, _fwprintf_p_l

_vsprintf_p, _vsprintf_p_l, _vswprintf_p, _vswprintf_p_l

_sprintf_p, _sprintf_p_l, _swprintf_p, _swprintf_p_l