vprintf, _vprintf_l, vwprintf, _vwprintf_l

Artigo
02/25/2013

Gravar saída formatados usando um ponteiro para uma lista de argumentos.Versões mais seguros dessas funções estão disponíveis, consulte vprintf_s, _vprintf_s_l, vwprintf_s, _vwprintf_s_l.

int vprintf( const char *format, va_list argptr ); int _vprintf_l( const char *format, locale_t locale, va_list argptr ); int vwprintf( const wchar_t *format, va_list argptr ); int _vwprintf_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 e vwprintf 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.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.

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

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.

vwprintf é a versão do largo- caractere de vprintf; as duas funções se comportam de forma idêntica se o fluxo é aberta no modo ANSI.vprintf 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.Observe que as cadeias de caracteres inválidos de formato e são detectadas resulta em um erro.

Mapeamentos da rotina de Genérico- texto

Rotina de TCHAR.H	_UNICODE & _MBCS não definidos	_MBCS definido	_UNICODE definido
_vtprintf	vprintf	vprintf	vwprintf
_vtprintf_l	_vprintf_l	_vprintf_l	_vwprintf_l

Requisitos

Rotina	Cabeçalho necessário	Cabeçalhos opcionais
vprintf, _vprintf_l	<stdio.h> e <stdarg.h>	<varargs.h>*
vwprintf, _vwprintf_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.