_vprintf_p, _vprintf_p_l, _vwprintf_p, _vwprintf_p_l

Artículo
04/10/2013

Escribir con formato salida mediante un puntero a una lista de argumentos, con la capacidad de especificar el orden en el que se utilizan los argumentos.

int _vprintf_p(
   const char *format,
   va_list argptr 
);
int _vprintf_p_l(
   const char *format,
   locale_t locale,
   va_list argptr 
);
int _vwprintf_p(
   const wchar_t *format,
   va_list argptr 
);
int _vwprintf_p_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

_vprintf_p y _vwprintf_p devuelven el número de caracteres y, sin incluir el carácter null de terminación, o un valor negativo si un error de salida aparece.

Comentarios

Cada una de estas funciones contiene un puntero a una lista de argumentos, los formatos y escribe los datos especificados en stdout.Estas funciones son diferentes de vprintf_s y de vwprintf_s sólo en que admiten la capacidad de especificar el orden en el que se utilizan los argumentos.Para obtener más información, vea parámetros posicionales De printf_p.

_vwprintf_p constituye la versión con caracteres anchos de _vprintf_p; las dos funciones se comportan exactamente igual si la secuencia se abre en el modo de ANSI._vprintf_p no admite actualmente la salida en una secuencia de UNICODE.

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 del subproceso 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.

Si format es un puntero NULL, o si la cadena de formato contiene caracteres de formato no válidos, 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, las funciones devuelven -1 y errno establecido en EINVAL.

Asignaciones de la rutina de Genérico- texto

Rutina de TCHAR.H	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_vtprintf_p	_vprintf_p	_vprintf_p	_vwprintf_p
_vtprintf_p_l	_vprintf_p_l	_vprintf_p_l	_vwprintf_p_l

Requisitos

Rutina	Encabezado necesario	Encabezados opcionales
_vprintf_p, _vprintf_p_l	<stdio.h> y <stdarg.h>	<varargs.h>*
_vwprintf_p, _vwprintf_p_l	<stdio.h> o <wchar.h>, y <stdarg.h>	<varargs.h>*

* Necesario para la compatibilidad de UNIX V.

La consola no se admite en las aplicaciones de Tienda Windows.Los identificadores estándar de la secuencia asociados a la consola, stdin, stdout, y stderr, deben redirigir antes de que las funciones en tiempo de ejecución de C pueden utilizarlos en las aplicaciones de Tienda Windows.Para obtener información adicional de compatibilidad, vea Compatibilidad en la Introducción.