_vcprintf_p, _vcprintf_p_l, _vcwprintf_p, _vcwprintf_p_l

Artigo
06/09/2015

As gravações formatado saída para o console usando um ponteiro para uma lista de argumentos, e parâmetros posicionais da suporte a cadeia de caracteres de formato.

Importante

Não é possível usar essa API em aplicativos executados no Tempo de Execução do Windows.Para obter mais informações, consulte Funções CRT sem suporte pelo /ZW.

int _vcprintf_p(
   const char* format,
   va_list argptr
);
int _vcprintf_p_l(
   const char* format,
   locale_t locale,
   va_list argptr
);
int _vcwprintf_p(
   const wchar_t* format,
   va_list argptr
);
int _vcwprintf_p_l(
   const wchar_t* format,
   locale_t locale,
   va_list argptr
);

Parâmetros

format
A especificação de formato.
argptr
Um ponteiro para uma lista de argumentos.
locale
A localidade a ser usada.

Para obter mais informações, consulte Sintaxe de especificação de formato: funções printf e and wprintf.

Valor de retorno

O número de caracteres que são gravados, ou um valor negativo se um erro de saída ocorre. Se format for um ponteiro nulo, o manipulador de parâmetro inválido será chamado, como descrito em Validação do parâmetro. Se a execução puder continuar, errno será definido como EINVAL será será retornado -1.

Comentários

Cada uma dessas funções usa um ponteiro para uma lista de argumentos, e usa a função de _putch para formatar os dados e gravar dados no console. (usa _putwch de_vcwprintf_p em vez de _putch. _vcwprintf_p é a versão de caracteres largos de _vcprintf_p. Usa uma cadeia de caracteres de ampla caractere como um argumento.)

As versões dessas funções que têm o sufixo _l são idênticas, exceto que elas usam o parâmetro de localidade informado em vez da localidade atual.

Cada argument (se houver) é convertido e é gerada de acordo com a especificação de formato correspondente em format. A especificação do formato da suporte a parâmetros posicionais de forma que você possa especificar a ordem em que os argumentos forem usados na cadeia de caracteres de formato. Para obter mais informações, consulte Parâmetros posicionais printf_p.

Essas funções não podem ser traduzidas caracteres de alimentação de linha na retorno- linha combinações de retorno de carro (CR-LF) quando são geradas.

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.

Essas funções para validar o ponteiro de entrada e a cadeia de caracteres de formato. Se format ou argument são NULL, ou se a cadeia de formato contiver caracteres de formatação inválidos, essas funções invoca o manipulador inválido do parâmetro, conforme descrito em Validação do parâmetro. Se a execução puder continuar, essas funções retornarão -1 e definirão errno a EINVAL.

Mapeamentos da rotina de texto genérico

Rotina Tchar.h	_UNICODE e _MBCS não definidos	_MBCS definido	_UNICODE definido
_vtcprintf_p	_vcprintf_p	_vcprintf_p	_vcwprintf_p
_vtcprintf_p_l	_vcprintf_p_l	_vcprintf_p_l	_vcwprintf_p_l

Requisitos

Rotina	Cabeçalho necessário
_vcprintf_p, _vcprintf_p_l	<conio.h> e <stdarg.h>
_vcwprintf_p, _vcwprintf_p_l	<conio.h> e <stdarg.h>

Para obter mais informações de compatibilidade, consulte Compatibilidade.

Exemplo

// crt_vcprintf_p.c
// compile with: /c
#include <conio.h>
#include <stdarg.h>

// An error formatting function that's used to print to the console.
int eprintf(const char* format, ...)
{
  va_list args;
  va_start(args, format);
  return _vcprintf_p(format, args);
}

int main()
{
   int n = eprintf("parameter 2 = %2$d; parameter 1 = %1$s\r\n",
      "one", 222);
   _cprintf_s("%d characters printed\r\n");
}

Consulte também

Referência

Console e E/S de porta

_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

va_arg, va_copy, va_end, va_start

Parâmetros posicionais printf_p

Partilhar via