vprintf, _vprintf_l, vwprintf, _vwprintf_l

Artigo
06/09/2015

Grava a saída formatada usando um ponteiro para uma lista de argumentos. Estão disponíveis versões mais seguras dessas funções; 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
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

vprintf e vwprintf 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 format for um ponteiro nulo, ou se a cadeia de caracteres de formato conter caracteres inválidos de formatação, o manipulador de parâmetro inválido 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 stdout.

vwprintf é a versão de caracteres largos de vprintf; as duas funções se comportarão de forma idêntica se o fluxo for aberto no modo de ANSI. No momento, vprintf 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.Observe que cadeias de caracteres de formato inválido são detectadas e resultam em um erro.

Mapeamentos da rotina de texto genérico

Rotina TCHAR.H	_UNICODE & _MBCS não definido	_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 tem suporte em aplicativos do Windows Store. Os manipuladores de fluxo padrão associados ao console — stdin, stdout e stderr — devem ser redirecionados antes que as funções de tempo de execução do C possam utilizá-los em aplicativos do Windows Store. Para informações adicionais de compatibilidade, consulte Compatibilidade.