_vcprintf_p, _vcprintf_p_l, _vcwprintf_p, _vcwprintf_p_l

Artigo
08/25/2010

Grave saída formatada para o console usando um ponteiro para uma lista de argumentos, com suporte para parâmetros de posição na seqüência de caracteres de formato.

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
Especificação de formato.
argptr
Ponteiro para a lista de argumentos.
locale
A localidade para usar.

Valor de retorno

O número de caracteres escritos, ou um valor negativo se ocorrer um erro de saída.If format é um ponteiro nulo, o manipulador de parâmetro inválido é chamado, conforme descrito em Validação de parâmetro. Se a execução for permitida para continuar, errno é conjunto para EINVAL e -1 é retornado.

Comentários

Cada uma dessas funções leva um ponteiro para uma lista de argumentos, e, em seguida, formata e grava dados determinados console usando o _putch (função_putwch para _vcwprintf_p). _vcwprintf_p é a versão de caractere largo da _vcprintf_p. Ele tem uma seqüência de caractere a toda a sistema autônomo um argumento.

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

Cada argument (se houver) é convertido e saída de acordo com a especificação de formato correspondente em format. A especificação de formato oferece suporte a parâmetros posicionais, que permite especificar a ordem em que os argumentos são usados na seqüência de caracteres de formato.For more information, see printf_p posicional parâmetros.

Essas funções não converter caracteres de avanço de linha em return–line de carro (CR-LF) combinações de feed durante a impressão.

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.

Essas funções validar o ponteiro de entrada e a seqüência de caracteres de formato.If format ou argument é NULL, ou se a seqüência de caracteres de formato contém caracteres inválidos de formatação, essas funções invocar o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro. Se a execução for permitida para continuar, essas funções retornam -1 e conjunto errno para EINVAL.

Mapeamentos de rotina de texto genérica

Rotina tchar.h	_UNICODE e _MBCS não definido	_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 Compatibility na introdução.

Exemplo

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

// An error formatting function 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");
}

parameter 2 = 222; parameter 1 = one 38 characters printed

Consulte também

Referência

Console e porta de E/s

_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

va_arg va_end, va_start

printf_p posicional parâmetros

Partilhar via