vfprintf、_vfprintf_l、vfwprintf、_vfwprintf_l

编写格式化输出使用指针参数列表。 这些功能的更安全版本存在; 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 
);

参数

  • stream
    为 FILE 结构的指针。

  • format
    格式规范。

  • argptr
    列表的指针参数。

  • locale
    使用的区域设置。

有关更多信息,请参见 格式规范

返回值

,如果输出错误,vfprintf 和 vfwprintf 返回编写的字符数,不包括终止 null 字符) 或负值。 如果 stream 或 format 是 null 指针,无效参数调用处理程序,如 参数验证所述。 如果执行允许继续,函数返回 -1 并将 errno 到 EINVAL。

有关这些属性和其他错误代码的信息,请参见 _doserrno、 errno、 _sys_errlist 和 _sys_nerr

备注

这些功能中的每一个采用指向参数列表,然后布局和编写特定数据。 stream。

vfwprintf 是 vfprintf的宽字符版本;,如果流在 ANSI 模式下,中打开两个函数具有相同的行为。 vfprintf 当前不支持输出到 UNICODE 流。

这些功能的版本与 _l 后缀的相同,只不过它们使用区域设置参数而不是当前线程区域设置。

安全说明安全说明

确保 format 不是用户定义的字符串。有关更多信息,请参见 避免缓冲区溢出

一般文本例程映射

TCHAR.H 实例

未定义的 _UNICODE _MBCS

定义的 _MBCS

定义的 _UNICODE

_vftprintf

vfprintf

vfprintf

vfwprintf

_vftprintf_l

_vfprintf_l

_vfprintf_l

_vfwprintf_l

要求

实例

必需的头

可选标头

vfprintf, _vfprintf_l

stdio.h 和 stdarg.h

varargs.h*

vfwprintf, _vfwprintf_l

stdio.h 或者 wchar.h,和 stdarg.h

varargs.h*

* 仅对 UNIX v 兼容性。

有关其他的兼容性信息,请参见中介绍的 兼容性

.NET Framework 等效项

不适用。若要调用标准 C 函数,请使用 PInvoke。有关更多信息,请参见 平台调用示例

请参见

参考

流 I/O

vprintf 函数

fprintf、_fprintf_l、fwprintf、_fwprintf_l

printf、_printf_l、wprintf、_wprintf_l

sprintf、_sprintf_l、swprintf、_swprintf_l、__swprintf_l

va_arg、va_copy、va_end、va_start