vfprintf, _vfprintf_l, vfwprintf, _vfwprintf_l

Escribir con formato salida mediante un puntero a una lista de argumentos.versiones más seguras de estas funciones existen; vea vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l.

int vfprintf(
   FILE *stream,
   const char *format,
   va_list argptr 
);
int _vfprintf_l(
   FILE *stream,
   const char *format,
   locale_t locale,
   va_list argptr 
);
int vfwprintf(
   FILE *stream,
   const wchar_t *format,
   va_list argptr 
);
int _vfwprintf_l(
   FILE *stream,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

Parámetros

• stream
  puntero a la estructura de FILE .

• 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

vfprintf y vfwprintf 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.Si stream o 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, las funciones devuelven -1 y errno establecido en EINVAL.

Para obtener información sobre éstos y otros códigos de error, vea _doserrno, errno, _sys_errlist, y _sys_nerr.

Comentarios

Cada una de estas funciones contiene un puntero a una lista de argumentos, los formatos y escribe los datos especificados en stream.

vfwprintf constituye la versión con caracteres anchos de vfprintf; las dos funciones se comportan exactamente igual si la secuencia se abre en el modo de ANSI.vfprintf 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.

Asignaciones de la rutina de texto genérico

rutina de TCHAR.H	_UNICODE y _MBCS no definido	_MBCS definido	_UNICODE definido
_vftprintf	vfprintf	vfprintf	vfwprintf
_vftprintf_l	_vfprintf_l	_vfprintf_l	_vfwprintf_l

Requisitos

rutina	Encabezado necesario	encabezados opcionales
vfprintf, _vfprintf_l	<stdio.h> y <stdarg.h>	<varargs.h> *
vfwprintf, _vfwprintf_l	<stdio.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.

Equivalente en .NET Framework

No es aplicable Para llamar a la función estándar de C, utilice PInvoke. Para obtener más información, vea La invocación de plataforma ejemplos.

Vea también

Referencia

E/S de la secuencia

funciones de vprintf

fprintf, _fprintf_l, fwprintf, _fwprintf_l

printf, _printf_l, wprintf, _wprintf_l

sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l

va_arg, va_end, va_start