Compartilhar via


_vprintf_p, _vprintf_p_l, _vwprintf_p, _vwprintf_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.

int _vprintf_p(
   const char *format,
   va_list argptr 
);
int _vprintf_p_l(
   const char *format,
   locale_t locale,
   va_list argptr 
);
int _vwprintf_p(
   const wchar_t *format,
   va_list argptr 
);
int _vwprintf_p_l(
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

Parâmetros

  • format
    Especificação de formato.

  • argptr
    Ponteiro para a lista de argumentos.

  • locale
    A localidade para usar.

Valor de retorno

_vprintf_p e _vwprintf_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 stdout. Essas funções diferem vprintf_s e vwprintf_s somente no que eles oferecem suporte à capacidade de especificar a ordem na qual os argumentos são usados. For more information, see printf_p posicional parâmetros.

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

If 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

_vtprintf_p

_vprintf_p

_vprintf_p

_vwprintf_p

_vtprintf_p_l

_vprintf_p_l

_vprintf_p_l

_vwprintf_p_l

Requisitos

Rotina

Cabeçalho necessário

Cabeçalhos opcionais

_vprintf_p, _vprintf_p_l

<stdio.h> e <stdarg.h>

<varargs.h> *

_vwprintf_p, _vwprintf_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

sistema::Console::gravar

Consulte também

Referência

Fluxo de E/S

Funções vprintf

_fprintf_p, _fprintf_p_l, _fwprintf_p, _fwprintf_p_l

_printf_p, _printf_p_l, _wprintf_p, _wprintf_p_l

_sprintf_p, _sprintf_p_l, _swprintf_p, _swprintf_p_l

vsprintf_s, _vsprintf_s_l, vswprintf_s, _vswprintf_s_l

va_arg va_end, va_start

_vfprintf_p, _vfprintf_p_l, _vfwprintf_p, _vfwprintf_p_l

_printf_p, _printf_p_l, _wprintf_p, _wprintf_p_l

printf_p posicional parâmetros