_vcprintf, _vcprintf_l, _vcwprintf, _vcwprintf_l

Artículo
04/10/2013

Escriba el formato en la consola mediante un puntero a una lista de argumentos.Versiones más seguras de estas funciones están disponibles, vea _vcprintf_s, _vcprintf_s_l, _vcwprintf_s, _vcwprintf_s_l.

Importante
Esta API no se puede utilizar en las aplicaciones que se ejecutan en tiempo de ejecución de Windows.Para obtener más información, vea Funciones CRT no compatibles con /ZW.

int _vcprintf(
   const char* format,
   va_list argptr
);
int _vcprintf_l(
   const char* format,
   locale_t locale,
   va_list argptr
);
int _vcwprintf(
   const wchar_t* format,
   va_list argptr
);
int _vcwprintf_l(
   const wchar_t* format,
   locale_t locale,
   va_list argptr
);

Parámetros

format
Especificación de formato.
argptr
Puntero a la lista de argumentos.
locale
La configuración regional a utilizar.

Para obtener más información, vea Especificaciones de formato.

Valor devuelto

El número de caracteres con tipo, o un valor negativo si un error de salida aparece.Si format es un puntero NULL, se invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros.Si la ejecución puede continuar, errno se establece en EINVAL y se devuelve -1.

Comentarios

Cada una de estas funciones contiene un puntero a una lista de argumentos, los formatos y escribe los datos especificados en la consola._vcwprintf constituye la versión con caracteres anchos de _vcprintf.Toma una cadena de caracteres como argumento.

Las versiones de estas funciones con el sufijo de _l son idénticas salvo que utilizan el parámetro locale pasado en lugar de la configuración regional actual.

Nota sobre la seguridad
Asegúrese de que format no es una cadena definida por el usuario.Para obtener más información, vea Para evitar las saturaciones del búfer.

Asignaciones de la rutina de Genérico- texto

Rutina de TCHAR.H	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_vtcprintf	_vcprintf	_vcprintf	_vcwprintf
_vtcprintf_l	_vcprintf_l	_vcprintf_l	_vcwprintf_l

Requisitos

Rutina	Encabezado necesario	Encabezados opcionales
_vcprintf, _vcprintf_l	<conio.h> y <stdarg.h>	<varargs.h>*
_vcwprintf, _vcwprintf_l	<conio.h> o <wchar.h>, y <stdarg.h>	<varargs.h>*

* Necesario para la compatibilidad de UNIX V.

Para obtener información adicional de compatibilidad, vea Compatibilidad en la Introducción.

Ejemplo

// crt_vcprintf.cpp
// 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(format, args);
}

int main()
{
   eprintf("  (%d:%d): Error %s%d : %s\n", 10, 23, "C", 2111,
           "<some error text>");
   eprintf("  (Related to symbol '%s' defined on line %d).\n",
           "<symbol>", 5 );
}