vfprintf_s、_vfprintf_s_l、vfwprintf_s、_vfwprintf_s_l

编写使用指针参数列表的格式化输出。 vfprintf、_vfprintf_l、vfwprintf、_vfwprintf_l 的一些版本提供安全增强功能（如 CRT 中的安全功能所述）。

int vfprintf_s(
   FILE *stream,
   const char *format,
   va_list argptr 
);
int _vfprintf_s_l(
   FILE *stream,
   const char *format,
   locale_t locale,
   va_list argptr 
);
int vfwprintf_s(
   FILE *stream,
   const wchar_t *format,
   va_list argptr 
);
int _vfwprintf_s_l(
   FILE *stream,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

参数

• stream
  指向 FILE 结构的指针。

• format
  格式规范。

• argptr
  指向参数列表的指针。

• locale
  要使用的区域设置。

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

返回值

如果输出有错误，vfprintf_s和 vfwprintf_s返回编写的字符数，不包括终止空字符或负值。 如果 stream或format 是空指针，或者，如果格式字符串包含无效格式字符，无效参数调用处理程序，如 参数验证 所述。 如果允许继续执行，则这些函数返回-1，并将errno设置为EINVAL。

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

备注

每个函数通过指针指向参数列表，然后布局和编写特定数据到stream。

这些函数与安全版本 的不同之处仅在于安全版本检查包含有效格式字符的format字符串。

vfwprintf_s 是 vfprintf_s的宽字符版本；如果流在 ANSI 模式下是公开的则两个函数具有相同行为。 vfprintf_s 当前不支持输出到 UNICODE 流。

这些带有 _l 后缀的函数的版本相同，只不过它们使用传递的区域设置参数而不是当前线程区域设置。

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

一般文本例程映射

要求

* 仅对 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