_vprintf_p, _vprintf_p_l, _vwprintf_p, _vwprintf_p_l

Artigo
02/25/2013

Gravar saída formatados usando um ponteiro para uma lista de argumentos, com a capacidade para 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
Formatar a especificação.
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

_vprintf_p e _vwprintf_p retorna o número de caracteres gravados, não incluindo o caractere de terminação zero, ou um valor negativo se ocorrer um erro de saída.

Comentários

Cada uma dessas funções tem um ponteiro para um lista de argumentos, então os formatos e grava dados para os dados a stdout.Essas funções diferem de vprintf_s e de vwprintf_s somente que oferecem suporte à capacidade para especificar a ordem em que os argumentos são usados.Para obter mais informações, consulte printf_p parâmetros posicional.

_vwprintf_p é a versão do largo- caractere de _vprintf_p; as duas funções se comportam de forma idêntica se o fluxo é aberta no modo ANSI._vprintf_p não tem suporte para a saída em um fluxo de UNICODE.

As versões dessas funções com o sufixo de _l são idênticas exceto que usam o parâmetro de localidade passado em vez de localidade atual da thread.

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

Se format é um ponteiro zero, ou se a cadeia de caracteres de formato de formatação contém caracteres inválidos, o manipulador inválido do parâmetro é invocado, como descrito em Validação de parâmetro.Se a execução é permitida continuar, funções e retornam -1 errno definido como EINVAL.

Mapeamentos da rotina de Genérico- texto

Rotina de TCHAR.H	_UNICODE & _MBCS não definidos	_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 a compatibilidade de UNIX V.

O console não é suportado em aplicativos de Windows Store .Identificadores padrões de fluxo associadas ao console, stdin, stdout, e stderr, devem ser redirecionada antes que as funções de tempo de execução das C pode usar em aplicativos de Windows Store .Para informações extras de compatibilidade Compatibilidade na introdução, consulte.